home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Apple Macintosh CD: Power Macintosh 5200/75
/
Apple Macintosh CD - Power Macintosh 5200_75.7z
/
Apple Macintosh CD - Power Macintosh 5200_75.bin
/
Extras
/
PowerTalk Extras
/
PowerTalk Mail Gateways
/
StarNine Internet Gateway
/
User Guide
/
User Guide
(
.txt
)
next >
Wrap
Common Ground
|
1994-07-08
|
633KB
|
3,904 lines
0^CGDC
Palatino
Helvetica
, Mail*Link
Internet for PowerTalk
User Guide
Palatino
Copyright
Helvetica
*@?Copyright
1994 StarNine Technologies Inc. and its Licensors.
/This guide and the software described in it are
copyrighted with
all rights reserved. Neither the guide nor the software may be copied in whole or part without the written consent of StarNine,
**zexcept as described in the license agreement included in this guide. To inquire about where you can purchase this product
please contact us at:
StarNine Technologies, Inc.
2550 Ninth Street, Suite 112
Berkeley, CA 94710 USA
Tel: 510-649-4949
Fax: 510-548-0393
Internet: info@starnine.com
StarNine
( License and Limited Warranty Agreement
nPlease see the License and Limited Warranty Agreement provided in a separate file that accompanies this guide.
Trademarks
*@vStarNine and Mail*Link are registered trademarks of StarNine Technologies, Inc. MacTCP, PowerShare, and PowerTalk are
**}trademarks and Apple, AppleTalk, EtherTalk, LocalTalk, Macintosh, Mac, and the Apple logo are registered trademarks of Apple
*)|Computer, Inc. All trade names referenced are the service mark, trademark or registered trademark of the respective manufac-
turer.
Support
*@~Though StarNine is not responsible for maintaining or helping you use the Software, StarNine does at its discretion offer sup-
port. For the information regarding where to go to get support simply double-click the
Support Info
file found on the distribution
**~diskette or contact the administrator who installed your software. To receive support you or your administrator must complete
**/and return the enclosed user Registration Card.
*a2MAKE SURE THAT YOU SEND IN YOUR REGISTRATION CARD.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
PREFACE
About This Guide 7
How to use this guide 7
Conventions 8
, CHAPTER 1
Getting Started 9
System requirements 9
*>,Mail*Link Internet for PowerTalk software 10
Balloon help 11
*>2Setting the GMT offset in the Map control panel 11
*?.Installing Mail*Link Internet for PowerTalk 12
Custom installation 14
Download All Messages option 14
*6)If you are updating a previous version 15
Contents
Palatino
Mail*Link Internet for PowerTalk
Helvetica
CHAPTER 2
Gateway Configuration 17
*U)Checking your local network connection 17
*>&Adding the gateway to the Key Chain 20
Basic configuration options 21
*7$Required mail account information 22
*65If SMTP and POP are supported on different systems 24
*6%The delete mail from server option 24
The current state field 25
Connect interval 25
Selecting a mail reader 26
)Activating or deactivating the gateway 27
Sending a test message 29
+370If the message doesn
t appear in your In Tray 31
Check your Out Tray 31
*:$Message status
in Out Tray 32
*;'Message status
waiting
in Out Tray 33
CHAPTER 3
Expert Configuration Options 35
*U!Opening the Preferences dialog 35
Saving or canceling changes 36
Keyboard shortcuts 36
*Enclosure and message body translations 37
Outgoing file enclosures 38
About Macintosh files 38
About MIME 39
*:%Default enclosure handling methods 39
File translations 40
Multiple file enclosures 41
Compression methods 41
Encoding 42
*60Limiting the total size of encoded enclosures 43
*67Macintosh character translations in the message body 43
SMTP/TCP network parameters 45
Setting TCP command timeouts 45
Palatino
Mail*Link Internet for PowerTalk
F&Choosing how name resolution occurs 46
Turning off the ping command 47
Connection times 47
+37 Changing the connect interval 48
*6 Putting outgoing mail on hold 48
'RFC headers and message body footers 49
Customizing RFC 822 headers 50
*7)Adding an optional message body footer 51
*6:Changing where RFC headers appear in your incoming mail 52
Changing the datestamp 52
Saving your configuration 54
Helvetica
, CHAPTER 4
Address Management 57
About Internet addresses 58
The domain name system 58
Example Internet addresses 59
*6 Internet address restrictions 60
5Copying Internet addresses to a catalog or Desktop 60
+36-Adding an Internet address to your catalog 61
*64Creating an address template from a reply address 62
(Creating new Internet address entries 62
+362Copying and modifying an Internet catalog entry 63
Creating a new user 64
#Using the Type-In Addresses pane 66
, CHAPTER 5
Solving Problems 69
*U%PowerTalk and PT/Internet problems 69
+36-Mail returned with
thumbs down
indicator 69
*6)Internet user receives a blank message 70
*7/Bad Configuration in the current state field 71
User Account field is empty 71
*6.Mail is deleted when you remove PT/Internet 72
/Gateway installation or configuration errors 73
PowerTalk problem reports 73
Palatino
Mail*Link Internet for PowerTalk
ML Test messages 75
Checking the log file 76
Automatic log file clearing 77
*64Using the Connect Now button to generate messages 77
Error messages 77
Numeric error codes 80
%How to remove the gateway software 83
Glossary 85
Index 91
Palatino
Mail*Link Internet for PowerTalk
Helvetica
PREFACE
About This Guide
KMail*Link Internet for PowerTalk is a personal e-mail gateway. You can use
*4 any mail-enabled application in
b PowerTalk
! to send and read mail. The gate-
Cway downloads incoming e-mail from your Post Office Protocol (POP)
*2Kaccount to your In Tray. It also processes your outbound mail and forwards
*2Jit to a Simple Mail Transfer Protocol (SMTP) host on the local TCP/IP net-
*2Hwork, which in turn can use SMTP or other protocols to forward the mail.
*dHThis guide explains how to set up your Mail*Link Internet for PowerTalk
*2Hgateway to send and receive mail, how to set up the gateway to send and
*2Greceive mail, and how to work with Internet addresses in the PowerTalk
environment.
How to use this guide
*YLAt this release, this guide presumes that you are using a Macintosh that is
*2Lalready connected to an IP network, or that you can obtain an IP connection
*2Mfrom the local network administrator. If you need to set up an IP connection
*2Hon your Macintosh, you must get help from the IP network administrator.
*d.This guide contains the following information:
Palatino
Mail*Link Internet for PowerTalk
): CHAPTER 1
; introduces the software and explains how to install it on
your Macintosh.
): CHAPTER 2
9 shows how to verify your IP connection, add the gateway
Gto your Key Chain, supply the basic required configuration, and send a
*2!test message through the gateway.
): CHAPTER 3
: describes options that modify certain defaults about the
gateway
s behavior.
): CHAPTER 4
: describes how to work with Internet addresses in the Pow-
erTalk environment.
): CHAPTER 5
: describes common problems. It also explains how to check
Athe log file, view problem reports, and interpret error messages.
Conventions
*YIThe term
PT/Internet
is shorthand for Mail*Link Internet for PowerTalk.
This guide uses
italic
)_7type to indicate emphasis. Italic type is also used to
>represent a parameter that you must replace with a real value.
*d Words in
Courier
monospace
6 font represent literal text that appears in a window
4or file, or examples of text you type at the cursor.
Zapf Dingbats
)C@: Text that is set off like this deserves special consideration.
MPORTANT
C: Text that is set off like this is information that you must know
to avoid time-consuming errors.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
, CHAPTER 1
Getting Started
MThis chapter lists system requirements, describes the Mail*Link Internet for
*2<PowerTalk components, and shows how to install the software.
System requirements
*YHThese are the requirements for running Mail*Link Internet for PowerTalk:
): PowerTalk
*>EMail*Link Internet for PowerTalk will run on any Macintosh system on
*2?which PowerTalk has been installed. PowerShare is not required.
More than 2 MB disk space
*>HIf PT/Internet determines that the Macintosh has less than 2 MB of disk
*2Gspace left, it stops sending or receiving new mail and flags a problem
report in the In Tray.
):4TCP/IP network connection to an Internet mail server
*>CPT/Internet uses Simple Mail Transfer Protocol (SMTP) to send your
*2Foutgoing mail to a host on the local network, which in turn uses SMTP
*2Jor other protocols to send your mail on to its destination. Mail arriving
*2Hfrom the Internet is received by a host (usually a Unix system) running
*2BPost Office Protocol Version 3 (POP). Usually, the same system
Helvetica
Getting Started
Palatino
Mail*Link Internet for PowerTalk
CInternet mail server
runs both SMTP and POP, but in some cases the
*23SMTP host and POP server are two separate systems.
*>GAt this release, the Macintosh must have a direct TCP/IP connection to
*2Gthe Internet mail server(s). The LAN connection can be Ethernet, Token
*2)Ring, or LocalTalk with a DDP-IP gateway.
POP mail account
*>@PT/Internet logs into the system on which your POP mail account
*2Bresides and downloads your incoming messages to your PowerTalk In
*2ETray. If you would like to run a POP server on your own Unix system,
*2Ayou can obtain
popper
from
ftp.cc.berkeley.edu
via anonymous
*2@FTP. See the network administrator if you need more information.
)Mail*Link Internet for PowerTalk software
*YIThe Mail*Link Internet for PowerTalk software includes the following com-
ponents:
Mail*Link PT/INET extension
*>GMail*Link PT/INET is installed in the Extensions folder within the Sys-
*2@tem Folder. This is the Personal Messaging System Access Module
*2@(PMSAM) that processes and exchanges mail between PowerTalk and
*2Gthe SMTP/POP server. It also provides an Internet address template for
*20adding Internet addresses to a personal catalog.
MacTCP
*>FThe MacTCP software is installed Control Panels folder within the Sys-
*2Mtem Folder if it doesn
t already exist in that location or the version found
*2Jthere is not the most recent. The Hosts file resides in the System Folder.
):;System Folder:Preferences:StarNine:Mail*Link PT/INET folder
*>HA folder named StarNine is created in the Preferences folder within the
*2HSystem Folder. Initially, it contains a folder named Mail*Link PT/INET.
*2MThis folder contains a key file, a Resources file, and a Prefs file that con-
*2$tains default Preferences settings.
*?KThe key file is required to validate the gateway each time it is executed.
*2GMail*Link Internet for PowerTalk finds the key file in this folder and
*2Hregisters the Key ID on the local AppleTalk network. If it doesn
t find
*27the key file here, it shuts down with an error message.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Balloon help
MFAfter Mail*Link Internet for PowerTalk begins operating, it will also
*2Dcontain the Mail*Link Log file and outbound messages that have been
*2+processed for transmission on the Internet.
Mail*Link Extras folder
*?HA folder named Mail*Link Extras is copied to the top level of the Macin-
*2Ftosh hard disk. It contains a StarNine business card and a file named
Support Info
that contains information about obtaining technical sup-
*2Fport. The ML Test application for testing TCP/IP and SMTP connections
*2Iis located in this folder within the Mail*Link PT/INET folder on the dis-
*2Htribution CD, but is not copied the Macintosh hard disk during installa-
tion.
Balloon help
*YIMail*Link Internet for PowerTalk has Balloon help. To turn it on, choose
*2HShow Balloons from the Balloon Help menu in the upper-right of the menu
*2Dbar, or press the Help key on your extended keyboard.Then, move the
*2Cmouse cursor over an item to see a brief explanation of that item.
*dGWhen you no longer need help, you can turn it off by choosing Hide Bal-
*2Cloons in the Balloon Help menu or by pressing the Help key on your
extended keyboard.
/Setting the GMT offset in the Map control panel
*YGBy default, PT/Internet datestamps your incoming mail with the current
*2IMacintosh time (the time the message is downloaded from the POP server).
*2MIn that case, the Map control panel is not consulted. However, if you use an
*2Cexpert option to control how your incoming mail is datestamped (as
described on
page 52
6), we recommend that you set your location in the Map
Ncontrol panel to enable PT/Internet to use your local time. If you do not set
*2Gthe Map control panel when using a specialized date stamp, GMT is used.
*dHTo PT/Internet, the important item in the Map Control Panel is the time
*2Fzone offset from GMT, which indicates the difference in hours/minutes
*2Jbetween your local time and GMT. The + check box on the right side of the
Helvetica
Getting Started
Palatino
Mail*Link Internet for PowerTalk
Itime zone line should be checked if you are in a location to the east of
*2OGreenwich and west of the international date line. To set your location, first
open the Map Control Panel (
FIGURE 1
FIGURE 1
Map window
LType your city
s name, or the name of a large city in the same time zone as
*2Nyour location, and click the Find button. A blinking light indicates the loca-
*2Ktion on the map. If the city you specify is not found, you can specify the
*2Lcity
s name, latitude, longitude, and time zone offsets, and then click the
*2KAdd City button. When the right location is blinking on the map, click the
Set button.
Zapf Dingbats
)CD: The Map Control Panel does not vary for daylight savings time. If
Ldaylight savings time is used in your time zone, you can set it in the Date
and Time Control Panel.
+Installing Mail*Link Internet for PowerTalk
*YETo install the PT/Internet software from a mounted CD volume, follow
these steps:
):@Open the folder containing the Mail*Link PT/INET Install script.
):ADrag-and-drop the Mail*Link PT/INET Install script on top of the
Installer.
f&ffdb
Palatino
Mail*Link Internet for PowerTalk
Helvetica
+Installing Mail*Link Internet for PowerTalk
MGAfter you dismiss the initial
splash
window, the Easy Install window
opens (
FIGURE 2
FIGURE 2
Easy Install Window
):9If you want to select which components to install, go to
Custom instal-
lation,
below
. Otherwise, click Install.
MGIf the current version of MacTCP is not already present in the Control
*2FPanels folder, MacTCP is installed along with PT/Internet. If you are
*2Eusing an earlier version of MacTCP and do not want to update it, see
Custom installation,
below
M8When the installation is finished, you see this message:
Click Restart, or press Return.
`3#2lFff
0x>ff
`330pff~
`330xff`
`332lffb
>ff``1
fF#3#
fdb30
f8c30
fLc30
3#2fc
330fc
330fc
332fc
323&f1
ffF#8`
Helvetica
Getting Started
Palatino
Mail*Link Internet for PowerTalk
Custom installation
*H,To customize which components are installed,
):.Click Customize in the main Installer window (
FIGURE 2
The Customize window opens (
FIGURE 3
FIGURE 3
Customize window
JFor a new installation, you should install at least the first three compo-
*2Gnents. When you click an item to select it, information about what the
*2/component contains is displayed below the list.
):1Select only those components you want to install.
Click Install.
Download All Messages option
*IJBy default, PT/Internet is configured to download your existing mail from
*2Kthe POP server to your In Tray the first time you activate the gateway. It
*2Kthen deletes the messages from the POP server. If you don
t want to delete
*2Gyour messages from the POP server, you can turn off the default option
described in
The delete mail from server option
on page 24
;If you want to download your existing mail to your In Tray
without deleting
E from the POP server, select the Download All Messages option in the
Customize window (
FIGURE 3
.). You can select this option now, as part of
@ffF10
323&f1
f`@f$
Palatino
Mail*Link Internet for PowerTalk
Helvetica
+Installing Mail*Link Internet for PowerTalk
Jthe custom installation procedure, or later, after you have sent test mes-
*2Bsages and checked that everything is working to your satisfaction.
*dKNote that this option has no effect unless you uncheck the default configu-
ration described in
The delete mail from server option
on page 24
Zapf Dingbats
MPORTANT
/If you have many messages in your POP account,
MDdownloading them all can take a while, consume a great deal of disk
*2*space, and affect performance on the Macin
tosh while the download is
MItaking place. In addition, if PT/Internet finds less than 2 MB free disk
*2Espace, it disables itself and flags a problem report in your In Tray.
&If you are updating a previous version
*HLIf you are updating a previous version of Mail*Link Internet for PowerTalk,
*25you see this message before the Restart window opens:
FIGURE 4
Important notice about updates
MThe installation procedure changes the file-id that PowerTalk uses to locate
*2Jthe Mail*Link PT/INET file. To write the new file-id in the PowerTalk con-
*2Bfiguration file, you must open and close the configuration window.
):/Log into PowerTalk after the Macintosh restarts
Open the Key Chain (see
page 20
for instructions).
):DDouble-click the PT/Internet Service item to open the configuration
window.
*>BThe Current State field in that window will say
Close Window and
Reboot.
):@Close the configuration window by clicking the close box in the
upper-left corner.
f`><>`
c303#
`338c3
33 Fdc33
`330c3
>`c33
`3?0c3
f`c33
`300c3
f`c33
`310c3
32`fdc33
Helvetica
Getting Started
Palatino
Mail*Link Internet for PowerTalk
You will see this message:
Click Continue.
Restart the Macintosh.
33 fF1
32`ff1
33230
13#30
`f<fc
30#21
f``ffg
f``ffF&
Palatino
Mail*Link Internet for PowerTalk
Helvetica
, CHAPTER 2
Gateway Configuration
7This chapter shows how to complete the following tasks:
):#Check the TCP/IP network connection
):!Add PT/Internet to your Key Chain
):'Supply the basic required configuration
):4Send a test message to verify that the gateway works
&Checking your local network connection
*XGPT/Internet requires a TCP/IP network connection between the Macintosh
*2Jand the Internet mail server (the SMTP host and POP server). This section
*2Fshows how to verify that the required TCP/IP network communication is
working.
Zapf Dingbats
MPORTANT
8: If MacTCP has not been configured, ask the IP network
MBadministrator for a valid IP configuration. If necessary, ask the
*2Aadministrator to configure MacTCP. Do not attempt to configure a
*2"TCP/IP connection using guesswork!
4Follow these steps to check your network connection:
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
):EOpen the MacTCP Control Panel and verify that it has been configured.
FIGURE 5
9 shows one example of a configured MacTCP Control Panel.
FIGURE 5
/Checking the MacTCP Control Panel configuration
):EIf you are not sure that MacTCP and its Hosts file within the System
*2HFolder have the required information, ask the network administrator for
help.
):COn the mounted CD volume, open the folder named
Mail*Link Extras
*2,within the folder named
Mail*Link PT/INET.
Launch the ML Test application.
Zapf Dingbats
)CA: ML Test uses its own name resolution and TCP timeout settings,
Dindependent of how the same settings are configured in PT/Internet.
*2FThese network-specific parameters can affect how ML Test sends a test
*2Emessage and even whether a test succeeds or fails. You can set these
*2Gparameters in ML Test by selecting Preferences from the Edit menu. See
SMTP/TCP network parameters
on page 45
for details.
):+Choose Send from the Test menu (Command-s).
The window shown in
FIGURE 6
opens.
<|f<ff
FffFff
>ff>ff
>f>>f>
0f||<x
230##
33230
0?330
13#30
&ffLL
Palatino
Mail*Link Internet for PowerTalk
Helvetica
&Checking your local network connection
FIGURE 6
Sending a test message
):MEnter the hostname of the Internet mail server in the first text entry field.
*>DUsually the Internet mail server is a Unix system running both SMTP
*2E(the protocol used to send your outbound mail) and POP (the protocol
*2Hused to access your incoming Internet mail). If you don
t know the host-
*2$name, ask the network administrator.
):CLeave the default values in the other three fields, and click Send.
*>JML Test initiates a connection with the host and sends a test message. It
*2Irecords its action, and then reports whether the test succeeded or failed
FIGURE 7
BSuccessful test of the IP connection with the Internet mail server
ML Test messages
on page 75
) if the test does not work successfully,
+or ask your network administrator for help.
fdc33
fpc33
~8c33
bLc33
0<<ff|
0fflff
0#32f`
0ffxff
0ffpff
0330~`
0ffxff
0330``
0fflff
1332b`
><<f>|
<PH*
R( "
R( "
R( "
p@>pL
p@>pL
32dc331
38pc331
8c331
1&Lc331
p@>pL
p@>pL
@@"@L
R( "
"(""/
"h""(
R( "
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
#Adding the gateway to the Key Chain
*YGIf you would like an introduction to the Key Chain, see your PowerTalk
*2GUser
s Guide. To add PT/Internet to your Key Chain, follow these steps:
Open the Key Chain.
*?GUnless you have modified the system defaults, you can select Key Chain
*25in the
Mail and Catalogs
submenu of the Apple menu.
):-If you use a PowerTalk access code, enter it.
):"Click Add in the Key Chain window.
):?In the dialog that opens, select PT/Internet and then click OK.
ff`f`
ff`f`
`ff~f
`ff`f
`ffbf
ff f`
f`><>`
``|<g
f``fFf`?
f``f>f`
<f>f`
0ff|>8
3003#30
3#3300
dc330
pc330
332300fFffLc33
`63303
|`<3303
`83303
`<3303
`63303
|0331
Palatino
Mail*Link Internet for PowerTalk
Helvetica
#Adding the gateway to the Key Chain
M-A new service item appears in your Key Chain:
):JDouble-click in the Service field of the new item, or select the item and
*56click Open, to open the gateway configuration window (
FIGURE 8
FIGURE 8
Gateway configuration window
Basic configuration options
*K0These are the configuration parameters shown in
FIGURE 8
):!Required mail account information
*>EYou must supply valid configuration information about the login name
*2Aand password you use to access your POP account, the name of the
*2JInternet mail server, your full Internet address, and your real name. See
Required mail account information
on page 22
``|<g
f``fFf`?
f``f>f`
<f>f`
HRRIBBR
RI2BR
R&rBN
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
):0Delete mail from server when placed in
In Tray
*>LBy default, this option is checked. It instructs PT/Internet to delete your
*2Dmessages from the POP server after downloading them to the In Tray.
The delete mail from server option
on page 24
Current State
*ADThis display field indicates the state of the gateway software. See
current state field
on page 25
Connect interval
*>HThis display field shows when PT/Internet connects to the Internet mail
server(s). See
Connect interval
on page 25
for defaults and
Connec-
tion times
on page 47
* for information on changing the defaults.
Mail reader
*>FBy default, the AppleMail application is opened when you double-click
*4)an Internet message in your In Tray. See
Selecting a mail reader
page 26
Preferences
Expert Configuration Options
on page 35
for details.
!Required mail account information
*H9To supply the required configuration, follow these steps:
):/Type your login name in the User Account field.
*?EThis must be the name you use to log into your POP account. For exam-
ple, type:
Courier
david
1The software uses this name to access your mail.
Zapf Dingbats
MPORTANT
: You must read
If SMTP and POP are supported on different
systems
on page 24
u5 if a different system is used for SMTP and POP. Ask
&the administrator if you are not sure.
):GClick Password. In the dialog that opens, type the password you use to
*2;log into your POP account (and confirm), and then click OK.
):HType the name of the Internet mail server in the Server field. For exam-
ple, type:
sparky.abc.com
Palatino
Mail*Link Internet for PowerTalk
Helvetica
#Adding the gateway to the Key Chain
MFPT/Internet uses this name as the SMTP host name. Typically, the same
*2Gsystem handles both outgoing and incoming mail, but this is not always
the case. See
If SMTP and POP are supported on different systems,
below
)p; if multiple mail servers are in use on your local network.
):=Type your full Internet address in the
Reply address
field.
*>GThe address you enter here enables recipients to reply to your mail by
*2Jusing the Reply function. Make sure this address is correct. For example,
type:
Courier
david@abc.com
MHIf you are not sure about your Internet address, ask the administrator.
About Internet addresses
on page 58
for background information.
Enter your real name.
*?EType your full name, including spaces. This name will be enclosed in
*2Iquotes and included in your reply address. Recipients will see it in the
field of certain mail programs. For example, type:
David Livingstone
METhe required mail account configuration is now complete. The configu-
*2(ration window looks something like this:
FIGURE 9
&Required information has been supplied
$,R@)HJR@
(RA)HJR@
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
)\ host and
server
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
2If SMTP and POP are supported on different systems
*HIIf the network administrator has set up two separate systems as Internet
*2Hmail servers, one to handle outbound mail (an SMTP host) and one to han-
*2Kdle the receipt of incoming mail (a POP server), you must include the name
*2Hof the POP server along with your login name in the User Account field.
*dHFor example, if you log into a system named
mozart
to read your mail,
*2Hand the network administrator has told you that a system named
sparky
*2Iis the SMTP host, you must type the following in your User Account field:
Courier
david@mozart.abc.com
LPT/Internet uses the name after the at-sign (@) as the POP server hostname.
*28The configuration window would look something like this:
FIGURE 10
!SMTP and POP on different systems
"The delete mail from server option
*HIWhen checked, this option tells PT/Internet to delete your messages from
*2Gthe POP server after downloading them to the In Tray. This option also
*2Haffects how PT/Internet handles your existing, read messages on the POP
*2Eserver
when checked, all mail is downloaded to the In Tray (and then
*25deleted from the server) at the next connect session.
Zapf Dingbats
MPORTANT
1: If you have many messages in your POP account,
Ddownloading them all can take a while, consume a great deal of disk
*2Espace, and affect performance on the Macintosh while the download is
*2Itaking place. In addition, if PT/Internet finds less than 2 MB free disk
$,R@)HJR@
(RA)HJR@
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
host
server
Palatino
Mail*Link Internet for PowerTalk
Helvetica
#Adding the gateway to the Key Chain
MJspace, it disables itself and flags a problem report in your In Tray. See
PowerTalk problem reports
on page 73
for details.
IIf you uncheck this option, your existing read messages will not be down-
*2Hloaded at all unless you use the Download All Messages option described
page 14
A. New mail will be downloaded to your In Tray as it is received,
Lbut it will not be deleted from the server. Eventually, your account on the
*2"POP server will grow quite large.
The current state field
*H9The Current State field can contain one of these strings:
Connect interval
*HFDuring a standard connect session, PT/Internet performs the following
actions:
Table 1 Software states
Genesis
5This state is shown when the PMSAM has been created,
*-'before PT/Internet has been configured.
Close Window and
Reboot
;This state occurs after updating to a later release of the
*.6PMSAM. It indicates that you must close the configura-
*.6tion window and restart the Macintosh to activate the
updated software.
Loaded
7The
Loaded
state is normal
it means that PT/Internet
*-7is present as a background process. The gateway is not
*.;necessarily running, it could be idle waiting for the next
*.&connect time or outgoing mail message.
Not Loaded
:This state indicates that PT/Internet is not running as a
*.6background process. It appears normally if you reopen
*.5the configuration window right after changing Prefer-
*.<ences and closing the window, or if your key file specifies
*-=a site license and the connect interval is greater than five
*.7minutes. Otherwise, it indicates an abnormal situation.
Bad Configuration
;This state indicates that the information contained in the
*.5PowerTalk Setup Preferences file for the PT/Internet
PMSAM is incorrect. See
Bad Configuration in the cur-
rent state field
on page 71
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
):$Extract outbound mail from PowerTalk
):"Use SMTP to send the outbound mail
):>Use POP3 to access your POP account and download incoming mes-
sages
):)Submit any received messages to PowerTalk
IBy default, PT/Internet initiates a connect session immediately when you
*2Isend mail from PowerTalk, or every 15 minutes, whichever comes first. To
change these defaults, see
Connection times
on page 47
The Connect Now button
'initiates a connect session immediately
. When
Jyou click the Connect Now button, PT/Internet completes a connect session
as described on
page 25
4. If you have incoming mail, it will download it to
6your In Tray; otherwise, no visible action will occur.
Zapf Dingbats
MPORTANT
>: If the Current State field displayed
Not Loaded
, you must
Gpress the Connect Now button twice to have the desired effect, once to
*2Fcause PowerTalk to load the gateway and again to initiate the connect
session.
Selecting a mail reader
*IJYou can select any mail-enabled application to be used automatically when
*2Iyou double-click an Internet message in your In Tray. Follow these steps:
Click Select.
FIGURE 11
*Choosing a default mail reader application
):EIn the next dialog, choose a mail-enabled application and click Open.
`<||8
fdf`Fffd
`>ffp
`>||8
bd`#30
332l1
338x1
31&l1
Palatino
Mail*Link Internet for PowerTalk
Helvetica
&Activating or deactivating the gateway
&Activating or deactivating the gateway
*YJAfter you have entered the required configuration data, the configuration
*2!window looks something like this:
M FIGURE 12
Basic configuration
LThe gateway has not yet been activated. To activate it, close the configura-
*2'tion window by clicking the close box,
or pr
essing Command-w
JIt may take a few seconds for the window to close, as PowerTalk activates
*2Fall of the personal gateway subsystems. When the configuration window
*2Ccloses, the Internet mail server name is visible in your Key Chain.
M FIGURE 13
$PT/Internet Service in the Key Chain
GThe PT/Internet gateway will continue to run, even if the Key Chain is
*2Ilocked. If you see an alert when you close the configuration window, see
Gateway installation or configuration errors
on page 73
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
33&f@
``|<g
f``fFf`?
f``f>f`
<f>f`
HRRIBBR
RI2BR
R&rBN
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
KTo deactivate the gateway temporarily, so that no mail is sent or received
*2Gbut PT/Internet remains loaded and present in the system, follow these
steps:
):8Open the Special menu in the Finder and choose
m at.
This dialog opens:
FIGURE 14
$Temporarily deactivating the gateway
):DUncheck the PT/Internet mail connection (click in the check box) to
deactivate the gateway.
To re-activate the gateway,
):8Open the Special menu in the Finder and choose
m at.
):GCheck the PT/Internet mail connection (click in the check box) to turn
the gateway back on.
*?IWhen the gateway is activated in this way, it executes a connect session
immediately.
E@DDT
ffF#8`
f`fdf`d
xpf<f8
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Sending a test message
Sending a test message
*jKThe best way to make sure that the gateway is working is to send a message
*2Gto your own Internet address. Unless you have changed the default gate-
*2Lway connect times, the entire verification procedure should take only a few
moments.
*dBTo send a message to yourself using AppleMail, follow these steps:
):7Open AppleMail by double-clicking the application icon.
):1Type a subject in the Subject field. For example,
Courier
test message
Enter a brief message, such as:
T)To verify that the gateway is functioning
):9Click the Recipients button to open an addressing window.
):HSelect the pencil icon at the left of the addressing window to open the
Type-in Addressing pane.
M FIGURE 15
/Sending a test message to your Internet address
):.Select PT/Internet in the Catalog pop-up menu.
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
):CType your own Internet address in the Type-in Addressing pane. For
example,
Courier
david@abc.com
):=Click To, and then click Done to close the addressing window.
Choose Send in the Mail menu.
Click Send in the next dialog.
FIGURE 16
AppleMail format is required
Zapf Dingbats
)C/: The message must be sent in AppleMail format.
GThe gateway processes the message and then initiates a connect session
*2Awith the Internet mail server. Within a few moments, the message
should arrive in your In Tray.
FIGURE 17
Test message in your In Tray
):?Double-click the message to verify that it is the one you sent.
330332
330330
30330ffg
30330
30332
0#32f`
0330~`
0330``
1332b`
)$RR
$Dj@
$Dr@
$Db
$Db
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Sending a test message
-If the message doesn
t appear in your In Tray
*HJIf the message doesn
t appear in your In Tray, there are several possible
*2Eexplanations. Maybe PT/Internet was unable to log into POP using the
*2Laccount information in its setup window, or one of the servers (outgoing or
*2Dincoming) is down. Or, it
s possible that the address was incorrect.
Check your Out Tray.
6If the message doesn
t appear in your In Tray after a
Afew moments, open your Out Tray. (Choose Out Tray in the Mailbox
*2Jmenu.) If you see a problem alert button in the upper-right corner of the
Out Tray window, click it.
A problem report window opens:
M FIGURE 18
Problem report window
PowerTalk problem reports
on page 73
for details on the messages
+you might see in the problem report window.
fFff``
f>ff``
ffdf``
rB J^
JLa&H
PA%(@R
E>F $
Click here
for reports
<f|<f
>f|<f
!$%($$
JC H
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
$Message status
in Out Tray.
'If the message status is
in the
GOut Tray the message has been extracted from PowerTalk and sent to the
*2HSMTP host. (Or, if the SMTP host is unavailable on the network, the mes-
*2<sage could be queued in the Mail*Link PT/INET spool folder.)
*dEIf the message has not appeared in your In Tray, wait a few moments.
*2GPT/Internet might not have had enough time to complete the connect ses-
*2Fsion yet, especially if the network is large and complex. After a few
*2Hmoments, try initiating another connect session by clicking the Connect
*2'Now button in the configuration window.
FIGURE 19
Using the Connect Now button
Zapf Dingbats
)CE If the Current State field displays
Not Loaded
, press the Connect
BNow button twice
once to cause PowerTalk to load the gateway and
*2Lthen again, when the Current State field displays
Loaded
, to initiate the
connect session.
JIf the Current State field goes quickly from
Not Loaded
Loaded
and
*2Lback again to
Not Loaded,
check the log file for messages. If the message
*2Mstill doesn
t appear in your In Tray after a few moments, check the log file
for messages. See
Checking the log file
on page 76
GIf you are able to log into your POP account (for example, if you have
*2Iappropriate terminal emulation software running on the Macintosh) log in
*2Nand see if the test message is there. If you see the test message in your POP
*2?mail account, check the login name and password you configured
Required mail account information
on page 22
). If you can
t log into the
3POP server, ask the network administrator for help.
$,R@)HJR@
(RA)HJR@
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
Click here
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Sending a test message
LIf the message doesn
t appear in your In Tray or POP account, it
s possible
*2Ithat PT/Internet was not installed correctly. Try removing the software,
described in
How to remove the gateway software
on page 83
, and then
re-install it.
*d'Message status
waiting
in Out Tray.
!If the message status in the Out
LTray is
waiting
, the message has not been sent to the SMTP host. If there
*2Mis a problem alert button in the upper-right corner of the window, click it.
*dEChoose
Send Now
from the Mailbox menu. Then, open the log file and
check for error messages. See
Checking the log file
on page 76
. Also,
Mmake sure there
s sufficient disk space available
if the gateway finds less
*2,than 2 MB of free space, it disables itself.
Helvetica
Gateway Configuration
Palatino
Mail*Link Internet for PowerTalk
Palatino
Mail*Link Internet for PowerTalk
Helvetica
, CHAPTER 3
Expert Configuration Options
GThis chapter shows how to set expert options that affect how Mail*Link
*2JInternet for PowerTalk operates. All of these options have default values
*2Kthat are reasonable for most networks. These are the general areas you can
modify with expert options:
):5Enclosure handling methods and character translations
SMTP/TCP network parameters
TCP/IP connection times
):1RFC header and message body footer customization
Opening the Preferences dialog
*XHTo configure expert options, open the Key Chain and double-click on the
*2>PT/Internet service to open the gateway configuration window.
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
+Then, click Preferences. This window opens:
FIGURE 20
Preferences window
OSelecting an icon in the left column (the item list) of the Preferences dialog
*20opens a group of related configuration options.
Saving or canceling changes
*HNIf you configure the options related to one icon and then select another one,
*2Ethe changes you made are remembered automatically. You don
t need to
*2Gclick OK each time
clicking OK saves all changes and closes the window.
*dGClicking Cancel closes the window without saving any changes. However,
*2Iif you have already opened a subdialog and saved changes within that win-
*2Idow, clicking Cancel at the top level of the Preferences window does not
cancel out those changes.
Keyboard shortcuts
*HGThe following keyboard shortcuts are recognized in the Preferences win-
):BThe
default
button has a double border
pressing Enter or Return
selects it.
):)Command-period selects the Cancel button.
`<|8x
332fd
330fp
?30~8
L132bL
<>f8x
I))HrRR
I))HBPRd
I))HBRR
D%!)"
)8zLL
330a1330
330q0330
330y0330
33<]033<
330O0330
330G0330
330C1330
%(@HBRH
Palatino
Mail*Link Internet for PowerTalk
Helvetica
'Enclosure and message body translations
):JYou can select an item in the left column (the item list) by pressing the
*2CCommand key and the item
s position in the list (Command-1 to open
*2AEnclosure options, Command-2 for SMTP/TCP options, and so forth).
):EYou can select a button within an options window by pressing the Com-
*2Dmand key and the first character of the button
s name (for example,
*2<press Command-4 to open the Headers/Footers window, and Com-
*23mand-f to select the Footer button in that window).
'Enclosure and message body translations
*X6Click the Enclosures icon to set these expert options.
M FIGURE 21
Enclosure handling preferences
Zapf Dingbats
MPORTANT
.: The options you set in this window apply to
outgoing
MGmessages and enclosures. If you need to send an enclosure that must be
*2Fhandled differently, you can re-open this window and set new options,
*2Hsend the file, and then set the options back to the general methods you
use most frequently.
'The Enclosures window has two sections:
`<|8x
332fd
330fp
?30~8
L132bL
<>f8x
I))HrRR
I))HBPRd
I))HBRR
D%!)"
)8zLL
330a1330
330q0330
330y0330
33<]033<
330O0330
330G0330
330C1330
%(@HBRH
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
Outgoing Enclosure Translations
*>HThese options affect your outgoing file enclosures. They are applied in
*2Jsequence in the order shown. For example, first the file type is examined
*2Gand the specified translations (if any) applied. The enclosure is then
passed
to the next option, which determines how multiple files are
handled, and so forth.
Outgoing Body Translation
*>FThis option controls how Macintosh characters in the body of your mes-
*2)sage appear to non-Macintosh recipients.
Outgoing file enclosures
*HMThis section describes your options for processing Macintosh file enclosures
*2Lfor transmission on the Internet. The main considerations are the file type
*2Iand the type of recipient system
whether you are sending to a Macintosh,
*29Unix, or PC, and whether or not the system supports MIME.
Zapf Dingbats
: See the
Glossary on page 85
for definitions of terms.
About Macintosh files.
1Most Macintosh files contain information used by
Kthe Finder, such as the name of the application that created the file (CRE-
*2BATOR) and the type of file (TYPE). For example, a file created in
*2%Microsoft
Word on a Macintosh has a
CREATOR
field of MSWD, which
Ctells the Finder to run Microsoft Word when a user opens the file.
*dLSome Macintosh files are plain text, such as any file saved as
Text Only.
*2GThese files have a TYPE of TEXT. When you are sending text files, your
*2Gmain concern is whether the recipient system supports MIME and whether
*2Pthe file itself contains 8-bit Macintosh characters (such as
) that might
*2Jnot be understood by a Unix or PC system. The options for processing text
enclosures are described in
File translations
on page 40
KOther Macintosh files are
binary
files, which might be an application or
*2Lanother type of Macintosh-specific file. In addition to Finder information,
*2Lthese files may contain data that can be shared with other types of systems
*2L(the
data fork
) and Macintosh resource information (the
resource fork
*2IThese files have a TYPE other than TEXT; for example, if a Word file con-
*2'tains binary formatting information, a
field of WDBN informs the
+Word application to display formatted text.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
'Enclosure and message body translations
IYour main concern when sending binary files is whether the recipient sys-
*2Htem supports MIME and whether that system will be able to use the Macin-
*2Mtosh-specific information. The options you can set to encode binary files is
described in
Encoding
on page 42
About MIME.
25The proposed MacMIME standard for enclosure encoding
Iis implemented in PT/Internet. This standard is 100% compatible with the
*2FMIME standard, but allows more flexibility when dealing with incoming
*29encoded MIME messages that contain Macintosh enclosures.
*dGMany types of systems and gateways are supporting MIME encoding as the
*2Knew Internet standard. If you receive a message from an Internet site, you
*2Ecan verify that the system supports MIME by checking whether the RFC
*2Hheader contains the string
MIME-Version:
a required string in the RFC
*2Kheaders of all sites that support MIME. MIME headers are treated in a simi-
*2Jlar manner to RFC822 headers, so their placement in a received message is
*2,based on the
Place RFC Header
option. See
page 49
for details.
FIf you select MIME for file enclosure handling and body text, and the
*2Hreceiving system or gateway doesn
t support MIME, the message body will
*2Nstill be readable for the most part. The recipient will see some unusual line
*26breaks and translated characters in the message body.
*dJHowever, if you enclose a large file that contains formatting information
*2Jand graphics, the translations and encoding that occur for MIME will make
*2Qthe enclosure difficult or impossible to use. If the recipient notifies you that
*2Kthe file you sent was unusable, send it again with different enclosure han-
*2<dling options selected in the Enclosures preferences window.
*d%Default enclosure handling methods.
$The default file enclosure settings
are as follows:
File Translations
*>8If the file is type TEXT, append it to the message body.
Multiple Files
*>+Keep multiple enclosures as separate files.
File Compression (None)
Encoding
*?(Binary files are encoded via Binhex 4.0.
Limit to enclosure size (None)
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
File translations
*H9Click the File Translations pop-up to view these options:
FIGURE 22
File Translations pop-up menu
NFile translations are performed based on the file type. At this release, most
*2.of these options relate to files of type TEXT.
*?6Do not apply a translation method based on file type.
Append TEXT Files to Mail
*?IIf the file type is TEXT, append it to the message body. The translation
*2Emethod specified for body text will be applied before the message is
*2<sent. This is recommended for sites that don
t support MIME.
Text to Plain Text
*?KIf the file type is TEXT, insert it in the message as is (8 bit or 7 bit).
Text to ISO-8859-1 Text
*?KIf the file type is TEXT, convert the characters in the file to ISO-8859-1
*2:before inserting it into the file as is (8-bit or 7-bit).
):"Text to Quoted-Printable Text
*?DIf the file type is TEXT, use the MIME quoted-printable format that
*2Eallows 8-bit characters and inserts line breaks every 78 characters.
):-Text to Quoted-Printable ISO-8859-1 Text
*?KIf the file type is TEXT, convert the characters in the file to ISO-8859-1
*2Dbefore converting the file into quoted-printable format. ISO-8859-1
*2Iincludes the full Latin alphabet as an 8-bit, single-byte, coded graphic
*2Echaracter set. It is a standard used by most of Europe and many Unix
*2 systems.
CThis is the recommended translation method for recipients that sup-
port MIME.
c03233
Palatino
Mail*Link Internet for PowerTalk
Helvetica
'Enclosure and message body translations
File Type to PC Extension
*>HExamine the file type of the enclosure and map it to an appropriate DOS
*2Kfilename extension. For example, text files will be assigned the extension
, and Excel files will be assigned the extension
. This is
*21useful when sending to a site that supports PCs.
Multiple file enclosures
*H7Click the Multiple Files pop-up to view these options.
FIGURE 23
Multiple Files pop-up menu
Keep as separate files
*>IDo not combine multiple files. Each file is handled separately according
*2Lto the other options; for example, text file are processed according to the
File translation
option and binary files are encoded separately using
Encoding
setting, described below.
This is the recommended setting
PACKIT format
*>ACombine multiple files in a compressed PACKIT format.When an out-
*2Fgoing mail message contains more than one enclosure, all of the enclo-
*2Gsures will be combined into one packed file and encoded. One enclosure
*2 is sent.
Compression methods
*H8Click the File Compression pop-up to view these options.
M FIGURE 24
File compression pop-up menu
JUnless you have version 3.07 or later of the StuffIt Engine
in the Exten-
*2Gsions folder within the System Folder, you cannot select a compression
*2Mmethod at this release. If you do have the StuffIt Engine installed, you can
select StuffIt
compression.
?fvffy
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
GIf you select StuffIt compression in this menu, the gateway compresses
*2Lyour outbound file enclosures in StuffIt format and creates a resource item
*2Kthat effectively
stamps
the enclosure as one created by a Mail*Link gate-
*2Iway. Most Macintosh mail systems have limits on the number of file enclo-
*2Lsures and the enclosure of hierarchical folders, which could be violated if
*2Dthe receiving gateway always expanded enclosed StuffIt archives.The
*2Mresource
stamping
of the archive before it is transmitted informs the gate-
*2Jway on the receiving end that the enclosure will not violate the mail sys-
*28tem
s limits and can safely be expanded before delivery.
Encoding
*H0Click the Encoding pop-up to view these options.
FIGURE 25
Encoding pop-up menu
AppleSingle
uuencode
*>EAdd the Finder information into the resource fork. Then, combine the
*2Fresource and data forks into a single file and encode that file using
UUENCODE
;. This is useful for sending Macintosh-specific or applica-
Htion files to Macintosh recipients when the receiving system or gateway
does not support MIME.
Binhex 4.0
Encode the file using the
BINHEX
% method. This is a widely used encod-
Cing method for binary files which is compatible with older systems.
Datafork Only
UUENCODE
GIf the enclosure has a resource fork, the gateway discards it and then
*2#encodes the data fork by using the
UUENCODE
method. Recommended
6for encoding files sent to older Unix systems and PCs.
MacBinary
UUENCODE
IPreserve both the resource and data forks of a binary file and encode it
using
UUENCODE
1. Recommended for Macintosh recipients or for PC
!networks running Microsoft
Mail.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
'Enclosure and message body translations
AppleSingle
*>EAdd the Finder information into the resource fork. Then, combine the
*2Kresource and data forks into a single file and encode the file in base 64.
*2GNon-Macintosh recipients will be unable to read the file, and audio or
*2?graphic elements may not be usable. If you use the recommended
*2HAppleDouble-MIME and the recipient tells you he couldn
t read the file,
try this option.
AppleDouble
*>FPreserve both the resource and data forks as separate file components
and encode them in base 64.
Z1This is the accepted industry standard for trans-
MJmission of MIME and is the recommended option for recipients that support
MIME.
Datafork Only
*>FDrop the resource fork of the file and then encode the remaining data
*2Jfork in base 64. Audio or graphics, such as those in GIF format, are part
*2Kof the data fork and are not lost, but may not be usable. If the recipient
*2Csystem or gateway cannot decode AppleDouble format, you can select
this option.
-Limiting the total size of encoded enclosures
*HPIf the
Limit total enclosure size
option is checked, this option controls the
*2Ltotal size of enclosures sent by the gateway. If you want to place a limit,
*2Hcheck the box and then specify the maximum enclosure size (in 1024 byte
*2Hmultiples). Mail that contains more enclosure data than allowed by this
limit will be returned to you.
*dLThe limit specified here is for the total size before encoding. In general,
*2Mencoding will increase the size of the data sent by about a third. If you do
)8H want to place a limit on the enclosure size, leave the item unchecked.
4Macintosh character translations in the message body
*HIThe Macintosh character set includes many
special
characters such as
*2Oor
, which require a full 8 bits to be represented. If a system that uses the
*2Keighth bit for another purpose receives a message that contains these char-
*2Kacters, it displays them as garbage characters. To avoid this problem when
*2Icommunicating with non-Macintosh recipients, you should select a transla-
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
Ktion method for body text. To specify a body translation method, click the
Body Translation pop-up menu.
FIGURE 26
Body Translation pop-up menu
*?2Do not perform any translations on the body text.
Quoted-Printable
*?FUse the MIME quoted-printable format that allows 8-bit characters and
*2)inserts line breaks every 78 characters.
): Quoted-Printable ISO-8859-1
*?FConvert the characters in the message to ISO-8859-1 before converting
*2Jthe file into quoted-printable format. ISO-8859-1 includes the full Latin
*2Malphabet as an 8-bit, single-byte, coded graphic character set. It is a stan-
*23dard used by most of Europe and many Unix systems.
This is the recom-
:mended translation method for recipients that support MIME
ISO-8859-1
*?FConvert the characters in the message to ISO-8859-1 before processing
them as is (7-bit or 8-bit).
RFC 822->987 USA
*?GTranslate illegal characters in addresses and body text as required by
*2CRFC 822. This is a recommended setting for older recipient systems.
Transparent 8-bit
*?FLeave the message body alone except for control characters other than
*2#tab, newline, and carriage return.
p$IMPORTANT: The receiving system and
Ball intermediary transport systems must be completely 8-bit clean.
ISO-8859-1
*?BConvert the Macintosh characters to the ISO-8859-1 character set.
*2GIMPORTANT: The receiving system and all intermediary transport systems
must be completely 8-bit clean.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
SMTP/TCP network parameters
SMTP/TCP network parameters
*Y4Click the SMTP/TCP icon to set these expert options.
M FIGURE 27
SMTP/TCP network parameters
JThe SMTP/TCP options are for setting specifics about the local IP network
*2Jand how name resolution will take place. The default values for these net-
work parameters are as follows:
):)TCP Command timeouts: default 127 seconds
):"Name Resolver: default MacTCP Only
Ping: checked by default
0To reset these defaults, read the next sections.
Setting TCP command timeouts
*HDPT/Internet sends out TCP commands to initiate connections with the
*2MInternet mail server. By default, it waits 127 seconds before timing out the
*2Dcommand and canceling the request. This is the recommended minimum,
*2Kbecause it allows for reliable connections even during high-traffic hours.
*2IHowever, if there are several IP routers on your local network, you will
*2Mimprove the reliability of your connection by setting this number higher, to
*2 191 or the maximum, 255 seconds.
`<|8x
332fd
330fp
?30~8
L132bL
<>f8x
ffdba
<||<8
>33033
03303?
~`c33
033030
``c33
033031
bdc330
<ff<83
%(@HBRH
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
IIf you need to increase the latency of the timeout period due to the com-
*2Fplexity of your local IP network configuration, click the TCP Command
*2"pop-up menu and select 191 or 255.
#Choosing how name resolution occurs
*HHName resolution is the process by which an IP address is obtained for a
*2Gspecified hostname. It can occur locally on the Macintosh, via address
*2Mrecords in the Hosts file within the System Folder, or on the network from a
domain name server.
Zapf Dingbats
)CD: This option affects how PT/Internet obtains the IP address of the
<Internet mail server(s). No other IP addresses are affected.
BIf the network does not support a domain name server, the default
MacTCP Only
name resolution method is always used, and an address
*2Precord for the Internet mail server(s) must be present in the local Hosts file.
*2IIf the network supports a domain name server and it is configured in the
*2GMacTCP Control Panel, the option you choose determines how PT/Internet
*2Hrequests IP addresses from the domain name server, which can affect how
outbound mail is routed.
*dHThe StarNine resolver understands Mail Exchange (MX) records, which can
*2Icontain routing information to another system. If the domain name server
*2Hsupports MX records, you can choose to request only MX record addresses
*2Oor to request first one format and then the other. These are your choices if a
*2<domain name server is specified in the MacTCP Control Panel:
MacTCP Only
*?HPT/Internet relies on address records. It first checks the MacTCP Hosts
*2Ofile. If that file is empty or missing, it contacts the domain name server. If
*2&the address is not found, it gives up.
MacTCP then StarNine
*?KPT/Internet first requests an address record. If the address is not found,
*25it requests an MX record from the domain name server.
StarNine then MacTCP
*?EPT/Internet requests an MX record first. If no MX record is found it
requests an address record.
StarNine Only
*?EPT/Internet requests an MX record. If the domain name server is down
*27or the appropriate MX record is not found, it gives up.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Connection times
Turning off the ping command
*HGWhen the Ping option is checked, PT/Internet sends an ICMP ping packet
*2Kto the Internet mail server before attempting to open a TCP/IP connect ses-
*2Ision. We recommend that you leave this option checked. It provides a sim-
*2Kple
are you there?
mechanism for contacting the host before attempting a
full TCP connection.
Zapf Dingbats
)CA: This option affects how PT/Internet contacts the Internet mail
M+server(s). No other IP hosts are affected.
NIf PT/Internet sends a ping packet and doesn
t receive a response, it repeats
*2Kthe ping packet 10 times at 1 second intervals before giving up on the con-
*2 nection.
*dLIf the Ping option is unchecked, PT/Internet attempts a full TCP connection
*2Ndirectly. If the target host is unavailable, the TCP connect will time out in
*2H127 seconds or longer. During that interval, PT/Internet cannot process
mail or perform any activity.
Connection times
*Y6Click the Connection icon to set these expert options.
M FIGURE 28
Connection times
`<|8x
332fd
330fp
?30~8
L132bL
<>f8x
%)HJR
33033
33033
%(@HBRH
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
MPT/Internet initiates a connect session when one or both of these conditions
has been met:
)::The specified time interval has passed: default 15 minutes
):EThe
Send outgoing mail immediately
option is checked and a message
is sent
Changing the connect interval
*HFDuring a standard connect session, PT/Internet performs the following
actions:
):$Extract outbound mail from PowerTalk
):"Use SMTP to send the outbound mail
):>Use POP3 to access your POP account and download incoming mes-
sages
):)Submit any received messages to PowerTalk
DPT/Internet uses very few resources to connect to a host if no mail
*2Iexchange takes place, so you won
t notice a change in your Macintosh per-
*2Iformance by decreasing the time interval unless the gateway is routinely
handling large amounts of mail.
*dKIf you want to change the interval, click the up-arrow (to increase it) or
*2Kdown-arrow (to decrease it). Or, enter a number directly in the edit field.
Putting outgoing mail on hold
*HIIf the
Send outgoing mail immediately
option is unchecked, the gateway
*2Nwaits until the specified time interval has passed before executing a connect
session.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
$RFC headers and message body footers
%RFC headers and message body footers
*Y9Click the Header/Footer icon to set these expert options.
M FIGURE 29
Headers and footers
,The Header/Footer window has these sections:
For outgoing mail
*>CYou can customize the RFC 822 header with RFC-compliant additions,
*2@or specify text to be appended to all of your outbound messages.
*?"Header customization: default none
*>!Message body footer: default none
For incoming mail
*>"RFC header location: default Start
*?:In Tray
Date Sent
is: default When downloaded by gateway
JBy default, the RFC header in incoming messages is placed at the start of
*2Fthe message, and the datestamp reflects the time when the PT/Internet
*20gateway downloaded the mail from the POP server.
*d;To change header or footer details, read the next sections.
`<|8x
332fd
330fp
?30~8
L132bL
<>f8x
n8v3"
`JI))HI
@JI))HI9
@JI))HII
)8I9"
33#338
3?33?0
303300
313310
c33&30
`)JRJR
@)BRJR
@)JRJR
c3030`
fdffg
c30><`
`ffL@c3
f&ff&
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
Customizing RFC 822 headers
*HGYou can specify additions to the standard RFC 822 header sent with all
*24Internet mail. The additions must be RFC-compliant.
*dFIf you are not familiar with RFC header fields, we recommend that you
*2Gread RFC 822 before adding information here. You can obtain RFC 822 by
*2Kcalling 800-235-3155 or 415-859-3695. To obtain an RFC electronically over
*2Athe Internet, use anonymous FTP from the <RFC> directory on host
*2GSRI-NIC.ARPA. If you are outside the Internet and don
t have access to
*2<FTP, you can receive RFCs by sending electronic mail to SER-
*2>VICE@SRI-NIC.ARPA. Put the RFC number in the
Subject:
field.
*dETo customize the RFC header, click Header Customization. An edit win-
*2Edow opens in which you can add RFC-compliant lines to be appended to
*2$the header of all outgoing messages.
FIGURE 30
"Window for customizing RFC headers
Zapf Dingbats
MPORTANT
<: If you choose to add RFC header lines, make sure that you
use RFC-compliant syntax.
HRFC header information in the format described in RFC 822, includes the
*2Kstandard
and
fields as well as other optional fields and inter-
*2Cmediate routing information between the source and target systems.
*dLYou can choose to add registered header fields such as the following to the
standard RFC header, where
Reply-address
is your reply address as speci-
"fied in the configuration window (
page 23
033#338
03?33?0
0303300
0313310
JI))HIJ
JI))HIy
JI))HI@B
`c-f3
JBHJH%
JBJJI%
R`c!
)0#!$
Palatino
Mail*Link Internet for PowerTalk
Helvetica
$RFC headers and message body footers
Courier
Return-Receipt-To:
Reply-address
Reply-To:
Reply-address
Errors-To:
Reply-address
MA header field is composed of a field name followed by a colon (:), followed
*2Hby the field body (such as a valid address), and terminated by a Return
*27character. The characters must be printable ASCII text.
&Adding an optional message body footer
*HFTo avoid confusion with Apple
s digital signatures, the term
message
*2Jbody footer
is used for the optional user mail signature portion of your
*2Moutbound Internet messages. It is a text string that will always be appended
*2Kto your messages. If you don
t add any text as a message body footer, your
*2)messages will end just as you type them.
Zapf Dingbats
)CH: Internet etiquette limits message footer to no more than 5 or 6 lines
of text.
JTo specify a text string, click Message Body Footer. An edit window opens
FIGURE 31
M FIGURE 31
!Optional message body footer text
JType the text you want to appear at the bottom of your outbound messages,
and then click OK.
*HI%%
%!)bAQ$% )JR
A%!)JA$
JI))HIJ
JI))HIy
JI))HI@B
J)J )H
D)HI)@
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
7Changing where RFC headers appear in your incoming mail
*HIIf a message is routed through several intermediary systems, the message
*2Jheader information can become quite extensive, so you can choose to place
*2Mit at the end of the message rather than at the beginning by choosing End in
the pop-up menu.
*dGIf you choose
No Header
in the pop-up menu, the RFC information will
*2Hbe left out of your incoming messages. We do not recommend this choice,
*2Hbecause RFC header information is useful in debugging delivery problems
*2*and determining where the mail originated.
Zapf Dingbats
)CA: RFC headers in incoming messages are indented by one space. If
Dthey were not indented, forwarded or reply mail containing both the
*2>new, outbound RFC header and the embedded RFC header would be
*2%interpreted as two distinct messages.
Changing the datestamp
*HGThe
In Tray Date Sent
pop-up menu lets you set datestamp information:
FIGURE 32
#Configuring a specialized datestamp
)CF: In the default setting, PT/Internet uses the Macintosh current time
Jto datestamp incoming mail as it is placed in the In Tray. If PT/Internet
*2Iis unable to make sense of the date and time contained in the message or
*2FRFC header (for example, if it is in an irregular format or uses time
*2Gacronyms unknown to the gateway) or if the date is outside of sensible
*2Mparameters (for example, if it is more than a year old or is well in advance
*2Jof the current local Macintosh time), then PT/Internet will always opt to
*28stamp the message with the local Macintosh current time.
When downloaded by gateway
*>HThis is the default setting, which causes PT/Internet to stamp incoming
*2>messages with the time it downloads the messages from the POP
*2Dserver.The Map control panel setting is ignored
local Macintosh cur-
*2Lrent time is used instead. If your In Tray is sorted by date, choosing this
*2Hoption ensures that new mail received by the gateway will appear at the
3303?
33#338
3?33?0
303300
313310
Palatino
Mail*Link Internet for PowerTalk
Helvetica
$RFC headers and message body footers
MItop of your In Tray mail list. To view when a mail message was sent, you
*28can examine the RFC header contained within the message.
header line
*?CThis option causes PT/Internet to stamp incoming messages with the
*2Jtime specified in the
header line (the first line of the message),
*2Gwhich shows when the message was sent. The line has a format like this:
Courier
S1From stack@starnine.com Wed Jan 26 17:37 PST 1994
Zapf Dingbats
MPORTANT
<: Not all POP servers pass this
line to PT/Internet.
MJMake sure that the
line is present in the headers of incoming mail
before choosing this option.
*?GIf your In Tray is sorted by date, choosing this option means that new
*2Gmail received by the gateway will not necessarily appear at the top of
*2Lyour In Tray mail list, so you might not notice its arrival right away. The
line may specify a time hours or days earlier than the date and
*2Gtime when you receive it. (When this option is set, you can open newly
*2Carrived mail in your In Tray by choosing
Open Next Letter
in the
mail-enabled application.)
*A8If you have set your location in the Map control panel (
page 11
MIPT/Internet uses the offset specified there to convert GMT to local time
*2:when creating the
Date Sent
field in your incoming mail.
header line
*?EThis option causes PT/Internet to stamp an incoming message with the
*2Gtime specified on the
Date:
line of the RFC header, which shows when
*26the message was sent. The line has a format like this:
Date: Wed Jan 26 15:28 EST 1994
MGIf your In Tray is sorted by date, choosing this option means that new
*2Gmail received by the gateway will not necessarily appear at the top of
*2Lyour In Tray mail list, so you might not notice its arrival right away. The
line may specify a time hours or days earlier than the date and
*2Gtime when you receive it. (When this option is set, you can open newly
*2Carrived mail in your In Tray by choosing
Open Next Letter
in the
mail-enabled application.)
*@8If you have set your location in the Map control panel (
page 11
MIPT/Internet uses the offset specified there to convert GMT to local time
*2:when creating the
Date Sent
field in your incoming mail.
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
On first
Received
header line
*>EThis option causes PT/Internet to stamp an incoming message with the
*2Itime specified on the first
Received:
line of the RFC header. The line
has a format like this:
Courier
T(Received: from starnine.starnine.com by
*26sparky.starnine.com (5.0/SMI-SVR4) id AA00330; Thu, 3
Feb 1994 07:30:18 +0800
KThe first
Received:
line in a header is added by the last mail server to
*2Greceive the message, usually your local POP server. (Each intermediary
*2Jmail server that forwards mail on the Internet adds a
Received:
line to
*2Ithe header.) So, the first
Received:
line indicates when the local POP
*2Fserver received the message. If you have set your location in the Map
control panel (
page 11
1) PT/Internet uses the offset specified there to
Fconvert GMT to local time when creating the
Date Sent
field in your
incoming mail.
Saving your configuration
*YIWhen you have finished setting the expert options you need, click the OK
*2Ibutton. You will be returned to the gateway configuration window. If you
*2Gchanged the connection details or mail account information, it will be
*2"shown in the configuration window.
FIGURE 33
;Configuration window must be closed to read new preferences
$,R@)HJR@
(RA)HJR@
IIJHI
%% ))bP
=% })C
!% E)B
&bf&F
"bg0v3!
$$8ba0I9
%) !JR
% )J
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Saving your configuration
IClose the configuration window by clicking the close box (the box in the
*24upper left corner of the window), or press Command-w
Zapf Dingbats
MPORTANT
5: PT/Internet will not recognize changes made in the
MDPreferences window until the configuration window is closed. If you
*2Fclose the configuration window after configuring Preferences and then
*2Ireopen it immediately, the Current State will display
Not Loaded
until
*2)the new Preferences have been recognized.
Helvetica
Expert Configuration Options
Palatino
Mail*Link Internet for PowerTalk
Palatino
Mail*Link Internet for PowerTalk
Helvetica
, CHAPTER 4
Address Management
JThis chapter provides an introduction to Internet addresses and shows how
*2Eto manage them in the PowerTalk environment. It describes how to add
*2IInternet addresses to your personal catalog and how to create individual
*2Baddress templates for Internet addresses you use most frequently.
*dKYou can create catalog entries or address templates in any of the standard
*2(PowerTalk ways, including the following:
):EDrag an Internet address from the From or Recipients field of a mail
*2'message to a catalog or to your Desktop
)::Copy an existing Internet catalog entry and then modify it
): Create a new user in the catalog
FYou can then use either the Find in Catalog command (in the
Mail and
*2GCatalogs
submenu of the Apple menu) or the Find Address pane within a
*2Mmail-enabled application to access the Internet addresses stored in your cat-
*2Ialog. Or, you can just open the catalog and drag an entry or address tem-
*23plate to the Recipients field of your mail message.
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
About Internet addresses
*Y#Internet addresses use this format:
Courier
+KT user-name
domain-name
user-name
: field is the Internet user
s login name. The name cannot
Kinclude spaces, tabs, or commas, and it does not use upper- and lower-case
*2&characters the way Macintosh names do.
domain-name
+< field is the Internet domain in which the user is located.
KThe entire world-wide Internet is divided into domains, and every Internet
*20address includes a domain name, as described in
The domain name sys-
below
An at-sign (
/) separates the user name from the domain name.
The domain name system
*IHBecause users would rather refer to machines using meaningful, symbolic
*2Fnames rather than long strings of numbers, the domain name system was
*2+created to map Internet addresses to names.
*dEThe hierarchical naming scheme accommodates a large set of names and
*2Hallows local autonomy in assigning names. A domain name is divided into
*2<subnames (called labels), separated by periods, for instance
english.pundit.edu
In this example,
)K: is the top-level domain and each label further specifies
Ba subdomain. The Network Information Center (NIC) administers the
*2?top-level domains and is responsible for assigning subdomains.
Table 2
1shows the top-level domains specified by the NIC.
Table 2
Top-level domains
Domain Name
Meaning
Commercial organization
Educational institution
Government institution
Military group
Major network support centers
Palatino
Mail*Link Internet for PowerTalk
Helvetica
About Internet addresses
JAfter an organization obtains authority for a domain from the NIC, it can
*2Aassign subordinate domain names. For instance, Pundit University
*2"obtained authority for the domain
Courier
pundit.edu
and the English Depart-
<ment at Pundit University obtained authority for the domain
english.pundit.edu
EThe organization with authority over a domain must maintain a domain
*2Iname server that maps domain names to Internet addresses. If the English
*2EDepartment at Pundit University obtained a new computer, Hamlet, the
hamlet.english.pundit.edu
Fwould be added to a domain name server
s database, along with the com-
puter
s Internet address.
Example Internet addresses
*HLIf you do not know the full Internet address of a person you need to reach,
*2Lyou should either ask that person for the correct address or ask the system
*2Gadministrator for help. The following examples show some legal address
formats.
*dFTo reach a user whose login name is
peter
at Pundit University, you
*2$could use an e-mail address such as:
peter@
pundit.edu
GMany networks on the Internet accept addresses with only the top-level
*2Jdomain name and then locally resolve the specific subdomains for a partic-
*2Nular user. This requires that the administrators of those networks set up the
*2Hdomain name server so that each user name is unique within that domain,
*2Hand then provide a way for an incoming address of
peter@pundit.edu
*2Ibe sent to the users particular local system, such as
peter@english.pun-
*2 dit.edu
Organizations other than above
Temporary ARPANET domain
ISO country code
Countries other than USA
Table 2
Top-level domains
(Continued)
Domain Name
Meaning
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
LOther networks on the Internet are not set up so
cleanly
and require that
*2Ieach incoming address includes additional subdomain information. In that
*2Hcase, you could send mail to a user named
peter
in the English Depart-
*20ment at Pundit University by using this address:
Courier
peter@
english.pundit.edu
Internet address restrictions
*HMThe Internet addresses you type cannot include the illegal characters listed
Table 3
=. If you are sending mail across an SMTP backbone to another
Jmail system where addresses allow these characters, use the substitutions
*4 shown in
Table 3
2Copying Internet addresses to a catalog or Desktop
*XEThis section describes how to use reply addresses or other recipient
*2Kaddresses in your incoming Internet mail to build up a catalog of Internet
*2Gaddresses or create address templates for addresses you use frequently.
Table 3
)Address translations required by RFC 822
Illegal characters
Translated to:
(space)
(underscore)
left parenthesis
right parenthesis
comma
colon
backslash
pound sign
at symbol
double-quote
)> # (where
is an integer)
less-than
)> # (where
is an integer)
greater-than
)> # (where
is an integer)
semicolon
)> # (where
is an integer)
left-bracket
)> # (where
is an integer)
right-bracket
)> # (where
is an integer)
Control characters
)> # (where
is an integer)
8-bit characters (value > 127)
)> # (where
is an integer)
Palatino
Mail*Link Internet for PowerTalk
Helvetica
2Copying Internet addresses to a catalog or Desktop
Zapf Dingbats
)CB: The address management techniques described in this section are
MDstandard PowerTalk methods. There is nothing unusual about managing
*2HInternet addresses except that a different address template and address
format must be used.
*Adding an Internet address to your catalog
*HKTo drag an Internet address from the From or Recipient field of a mail mes-
*2Jsage to a personal catalog, first open the mail message. Then, open a per-
*2Lsonal catalog by double-clicking the file or by choosing
Personal Catalog
*2Gin the
Mail and Catalogs
submenu of the Apple (
) menu, and drag the
address to the catalog window.
M FIGURE 34
3Adding an Internet address to your personal catalog
KYou can access an address stored in your catalog by using the Find in Cata-
*2Dlog command (in the
Mail and Catalogs
submenu of the Apple menu),
*2Jthe Find Addresses pane in a mail message, or by opening your catalog and
*2=dragging the entry to the Recipients field of a mail message.
FHw7$
JBIH$
JBIH$
JBIH$
2D@"D
"<@"D
"D@"D
D"D@"D
D"D@"D
!I= y
AI! A
!I= y
AI! A
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
1Creating an address template from a reply address
*HIWhen you receive Internet mail from someone you are likely to contact in
*2Mthe future, you can create an address template for that user by dragging the
*2!address to the Macintosh Desktop.
FIGURE 35
Creating an address template
HYou can use the address stored in the template by dragging it from your
*22Desktop to the Recipients field of a mail message.
%Creating new Internet address entries
*jIThis section shows two ways to add Internet addresses to a personal cata-
)::Copy an existing Internet address entry and then modify it
Create a new user from scratch
FHw7$
JBIH$
JBIH$
JBIH$
2D@"D
"<@"D
"D@"D
D"D@"D
D"D@"D
Palatino
Mail*Link Internet for PowerTalk
Helvetica
%Creating new Internet address entries
/Copying and modifying an Internet catalog entry
*HJTo copy an existing Internet address entry and then modify it to create a
*2&new catalog entry, follow these steps:
):HOpen a personal catalog by double-clicking the file or by choosing
*2Csonal Catalog
in the
Mail and Catalogs
submenu of the Apple (
menu.
):ISelect an entry that contains an Internet address, and then choose Dupli-
cate in the Finder
s File menu.
M FIGURE 36
&Duplicating an existing Internet entry
):0Type the name of the new user in the Name field.
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
):DOpen the new entry and then change the Name field in the Electronic
Addresses window.
):GDouble-click the name field to open the Internet address template, and
*2&enter the new user
s Internet address.
Creating a new user
*HGTo add one or more Internet addresses to a catalog, follow these steps:
):HOpen a personal catalog by double-clicking the file or by choosing
*2Csonal Catalog
in the
Mail and Catalogs
submenu of the Apple (
menu.
Create a new user.
"2)J)
#2"`
)K)
D "ls
X B2$Ld
@ B"'
"2)J)
)K)
<f`f<l
ff`ffq
ff`|fa
~f``~`
bf@`ba
<f``l
ff``q
ff`na
~f`fa
`f`fa
bf@fa
Palatino
Mail*Link Internet for PowerTalk
Helvetica
%Creating new Internet address entries
):0Type the name of the new user in the Name field.
):DOpen the new entry and select Electronic Address in the pop-up menu.
Click Add.
):BSelect PT/Internet Address in the next dialog, and then click Add.
M FIGURE 37
%Opening the Internet address template
):8Type the user
s name in the Electronic Addresses window.
330363
3303<3
33038?
3303<0
1303#
330361
"2)J)
#2"`
)K)
D "ls
X B2$Ld
@ B"'
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
):ADouble-click the INET icon to open the Internet address template.
*>/The Internet address template looks like this.
FIGURE 38
Internet Address template
):FHighlight the text in the edit field and type the appropriate address.
Close the address template.
Close the catalog entry.
Using the Type-In Addresses pane
*YFThe Type-In Addresses pane lets you manually type the address in your
*2,mail message. To use it, follow these steps:
):FClick the Recipients button in the mail interface of any mail-enabled
*2*application to open the addressing window.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Using the Type-In Addresses pane
M FIGURE 39
Opening the addressing window
):ESelect the pencil icon at the left of the window to open the Type-in
Addressing pane.
):.Select PT/Internet in the Catalog pop-up menu.
):2Type the user
s address in the Address edit field.
M FIGURE 40
The Type-In Addressing pane
):FDouble-click the name or select it and click the To button to add the
*23name to the Recipients list in your e-mail message.
Click Done.
I)H%)
!H(H!)
Helvetica
Address Management
Palatino
Mail*Link Internet for PowerTalk
Palatino
Mail*Link Internet for PowerTalk
Helvetica
, CHAPTER 5
Solving Problems
HThis chapter describes some problems you might see when using Mail*Link
*2HInternet for PowerTalk, and shows the problem reporting mechanisms used
by the software.
"PowerTalk and PT/Internet problems
*YLIf the gateway does not appear to be functioning, first check for a problem
report in the In Tray. See
PowerTalk problem reports
on page 73
*Mail returned with
thumbs down
indicator
*HLIf a message is returned to your Out Tray with an
through its icon, dou-
*2Pble-click the message to open it. If one of the recipient addresses is preceded
*2Fby a
thumbs down
icon, double-click on the thumbs-down indicator to
*27open a window containing information about the problem.
*dHA
thumbs down
problem is usually either an invalid address or invalid
*2Fmessage format. Depending on which message you see in the problem win-
*2Ldow, either verify the recipient address or make sure that you sent the mes-
sage in AppleMail format.
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
FIGURE 41
(AppleMail format selected in pop-up menu
JIf you are sure that the Internet address is correct and AppleMail format
*2Ewas used, try removing the PT/Internet Service from the Key Chain by
*2Jopening the Key Chain, selecting the service, and clicking the Remove but-
*2=ton. Then, add the PT/Internetservice again, as described in
Adding the
$gateway to the Key Chain
on page 20
Zapf Dingbats
MPORTANT
= Before you remove PT/Internet, copy the contents of your In
Tray to a folder. See
Mail is deleted when you remove PT/Internet
page 72
for related issues.
MIf the problem persists, try removing PT/Internet and then re-installing it.
How to remove the gateway software
on page 83
PIf the mail is still returned after you have verified the address and tried the
*2Isteps above, you should remove the PowerTalk Setup Preferences file from
*2ISystem Folder:Preferences and then add the PT/Internet service back into
*2Hthe Key Chain. If removing the PowerTalk Setup Preferences file doesn
*2-help, you might have to re-install PowerTalk.
&Internet user receives a blank message
*HKPT/Internet requires that all outgoing mail is in AppleMail format. If you
*2=need to send a message in some other format supported by the
*2Jmail-enabled application you are using, check the Multiple Formats option
*4 in the Send dialog, as shown in
FIGURE 42
330332
330330
30330ffg
30330
30332
0#32f`
0330~`
0330``
1332b`
)$RR
Palatino
Mail*Link Internet for PowerTalk
Helvetica
"PowerTalk and PT/Internet problems
M FIGURE 42
Multiple mail formats
IAs long as the AppleMail format is included, PT/Internet can forward the
*2>message. Otherwise, the recipient may receive a blank message.
,Bad Configuration in the current state field
*HJThe
Bad Configuration
state indicates that the information contained in
*2Hthe PowerTalk Setup Preferences file for the PT/Internet PMSAM is incor-
rect.
Zapf Dingbats
MPORTANT
= Before you remove PT/Internet, copy the contents of your In
Tray to a folder. See
Mail is deleted when you remove PT/Internet
page 72
for related issues.
GTry removing the PT/Internet Service from the Key Chain by opening the
*2LKey Chain, selecting the service, and clicking the Remove button. Then, add
*2.the PT/Internetservice again, as described in
Adding the gateway to the
Key Chain
on page 20
MIf the problem persists, try removing PT/Internet and then re-installing it.
How to remove the gateway software
on page 83
LIf the condition still persists, you should remove the PowerTalk Setup Pref-
*2Ierences file from System Folder:Preferences and then add the PT/Internet
*2 service back into the Key Chain.
User Account field is empty
*HJIf the User Account field keeps coming up empty in the PT/Internet config-
*2Juration window, but the other required mail account fields retain the con-
*2Ifiguration data, PT/Internet might be encountering a problem interacting
with PowerTalk.
330332
330330
30330ffg
30330
30332
HH3>>1
0#32f`
0330~`
0330``
1332b`
P(3>>1
HH0|<|8
8fFfd
)$RR
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
Zapf Dingbats
MPORTANT
= Before you remove PT/Internet, copy the contents of your In
Tray to a folder. See
Mail is deleted when you remove PT/Internet
page 72
for related issues.
>Try removing the PowerTalk Setup Preferences file from System
*2KFolder:Preferences, and then restarting the Macintosh. After the Macintosh
*2Krestarts, open the Key Chain and add the PT/Internet service back into the
*2GKey Chain. This should fix the problem and PT/Internet should now work
correctly.
+Mail is deleted when you remove PT/Internet
*HJOnce you have installed a personal gateway such as Mail*Link Internet for
*2HPowerTalk in the Key Chain, if you subsequently remove the gateway from
*2Hthe Key Chain, any mail in your In Tray that has been downloaded by the
*2Hgateway will be deleted. We strongly advise you to copy the contents of
*2Hyour In Tray to a folder before removing any personal gateways from the
*2HPowerTalk Key Chain. However, if you forget to copy your In Tray before
*2Fremoving PT/Internet, you can recover your lost messages by following
these steps:
):DOpen the
IPM Bin
folder within the
PowerTalk Data
folder in the
System Folder.
*>EAll of the messages are still there with blank icons and 8-digit hex
names.
):,Drag the files on top of the AppleMail icon.
*>EThe files will launch the AppleMail application and display your mes-
*2!sages, including file enclosures.
*?GIf you prefer, you can open the files within AppleMail and then choose
Save As
in the AppleMail File menu to specify a name for each mes-
*2Ksage and restore the original type and creator. That way, the files
icons
*2Fwill be restored and you can then open them by double-clicking on the
*2Efile. Or, you can use a file utility such as FileType
, Disk Top
*2GResEdit
to restore the files
original type (lttr) and creator (lap2).
Palatino
Mail*Link Internet for PowerTalk
Helvetica
,Gateway installation or configuration errors
,Gateway installation or configuration errors
*YHThe following messages may be displayed in alert dialogs when you close
the configuration window:
Courier
*M?You have not specified a login name. Changes will not be saved
if you continue.
+:>FClick Stop in the alert dialog to return to the configuration window.
*2CThen, enter your POP login name and close the configuration window
again. See
Required mail account information
on page 22
for details.
>You have not specified a Server. Changes will not be saved if
you continue.
+s=FClick Stop in the alert dialog to return to the configuration window.
*2?Then, enter the name of the SMTP host/POP server in the Server
field. See
Required mail account information
on page 22
for details.
?This gateway's file-id has changed. You must reboot the system
*..for this gateway to be activated by PowerTalk.
+:=KThis alert is informational only. After updating PT/Internet by installing
*2Ia new version, you opened the configuration dialog and closed it, as you
*4Care required to do. The next step is to restart the Macintosh. See
page 15
for details.
PowerTalk problem reports
*HEIf PT/Internet reports a correctable problem to PowerTalk, PowerTalk
*2Iwaits until you have resolved the problem before allowing PT/Internet to
continue functioning.
*dIIn general, PT/Internet reports problem conditions through the PowerTalk
*2Gproblem reporting mechanism, which causes a button to be displayed and
*2Jactivated in the top right corner of the In Tray or Out Tray, as shown in
*2 FIGURE 43
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
FIGURE 43
.Button indicating problem reports in PowerTalk
HClick the problem alert button to open a Mailbox Problems window. These
*2;are the problem reports that may be related to PT/Internet:
Courier
*L=A valid key file was not found. The gateway will not execute!
+:=EThis message means that the key file distributed with PT/Internet is
*2Heither missing or somehow corrupted. Call StarNine at (510) 649-4949 to
obtain a new key file.
>Key registration failed. A Duplicate copy of this gateway may
*.;be executing in your network. The gateway will not execute!
+:=FThis message means that PT/Internet detected a duplicate copy of your
*2Egateway ID on the AppleTalk network. It
s possible that another user
*2#installed a copy of your software.
-There
s not enough free disk space available.
+:=HIf PT/Internet determines that the Macintosh has less than 2 MB of disk
*2Ispace left, it stops receiving new mail and creates this problem report.
*2AYou must free up some space before you can receive your incoming
Internet messages.
>Unable to initialize StarNine interfaces. Gateway will not be
*- executed.
+:>FThis message is rare
it can indicate a problem in PowerTalk. Please
*2/contact StarNine at (510) 649-4949 to get help.
Unable to login.
+:=FOpen the Key Chain, and then open the PT/Internet service. Check that
*2Ethe login name and password you specified are the right ones for log-
*2&ging into your Internet mail account.
fFff``
f>ff``
ffdf``
rB J^
JLa&H
PA%(@R
E>F $
Palatino
Mail*Link Internet for PowerTalk
Helvetica
,Gateway installation or configuration errors
IWhen you have taken the appropriate action to resolve the problem, click
*2MResolve. If you click Resolve before fixing the problem, PT/Internet is acti-
*2Fvated again and the same message will be generated again and added to
*2Hthis window. If the problem is noted more than once, it can cause Power-
*2+Talk to deactivate the PT/Internet service.
ML Test messages
*HEIf the ML Test status window shows a successful connection with SMTP
*2Iprotocol messages being exchanged, but the reply messages from the Inter-
*28net mail server contain a syntax error flagged with a
error code (such
Kas 501, 502, 504, 550, 551, 553), modify the default value in the hostname
*2Efield of the Send window to contain your domain name in the standard
*2Ddomain-name format
abc.com
. Then, execute the Send command again.
*2EMost SMTP systems accept the default
Testing
hostname, but in some
*2Icases you need to modify this field to contain a real hostname to use ML
Test successfully.
*dAThe following messages may be displayed in ML Test alert dialogs:
Courier
ML Test unable to load driver
+:=EThis message will appear if the MacTCP driver cannot be found in the
*2GControl Panels folder within the System Folder or cannot be opened. It
*2Mcan also occur if a duplicate IP address is being used. If you are sure that
*2Ethe MacTCP software is where it should be and that you are using the
*2Gright IP address for your Macintosh, quit ML Test, increase the amount
*22of its application memory, and try the test again.
ML Test unable to open stream
+:=EQuit ML Test, increase the amount of its application memory, and try
the test again.
%ML Test unable to open TCP connection
+:=IThis condition is a result of either a bad IP address, no physical media
*2Kconnection, or if the Macintosh is connected to LocalTalk, it could be the
*2Fresult of an incorrect DDP-IP gateway setup. Check the IP address you
*2Aconfigured in the MacTCP area of the Control Panel. If this is a
*2Elegal/unused address, then check all connections and any DDP-IP gate-
*2Eway setup. If everything seems to be in order but the TCP connection
*2Dstill cannot be established, try rebooting the Macintosh and DDP-IP
gateway.
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
Courier
&ML Test unable to connect to SMTP host
+:=HAn error of this sort is due to a SMTP protocol issue. Either the Macin-
*2Etosh or the other SMTP host is not responding the way that the other
machine expects.
ML Test unable to send SMTP
+:=HAn error of this sort is due to a SMTP protocol issue. Either the Macin-
*2Etosh or the other SMTP host is not responding the way that the other
machine expects.
ML Test unable to close SMTP
+:=HAn error of this sort is due to a SMTP protocol issue. Either the Macin-
*2Etosh or the other SMTP host is not responding the way that the other
*2Dmachine expects and the connection was closed from one host without
the other knowing it.
"ML Test unable to close connection
+:=DThe TCP connection was closed previously due to some other problem.
*2EThis could be a break in the physical media or one of the SMTP hosts
stopped talking.
)ML Test unable to create temporary files.
+:=IThis error happens when the disk that ML Test is running on is locked or
*2Hout of space. Unlock the disk or free some space on the disk, whichever
is needed.
ML Test unknown failure.
+:=ESome unknown error has occurred. Look at the error message displayed
*2@in the text of the window and correlate it with the error codes.
Checking the log file
*YGPT/Internet writes status and error messages to a file named Mail*Link
*24PT/INET Log. The log file is located in this folder:
*d4System Folder:Preferences:StarNine:Mail*Link PT/INET
*dPThe log file is a text file that can be opened by any application that can read
*2Ktext files, such as the TeachText application or almost any other word pro-
cessing program.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Checking the log file
IIf PT/Internet does not seem to be sending or receiving mail, you should
*2Gopen this file and check the messages. Error messages normally have an
*2.error number that helps identify the problem.
Automatic log file clearing
*HNThe log file will not grow larger than 31KB. If it reaches 31KB, a message is
*2Linserted at the top of the file and new log messages overwrite existing mes-
*2Psages starting at the top of the file. You can always locate the latest informa-
*2Btion by looking at the time stamp that precedes every log message.
*dNEach time the Macintosh system is restarted, if the log file has reached 31KB
*2Lin size, the file is moved to the Trash and the current date is appended to
*2Ithe file
s name. The old log files are deleted only when you execute the
Empty Trash command.
1Using the Connect Now button to generate messages
*HDTo force an immediate connect session, open the Key Chain, open the
*2IPT/Internet service, and click the Connect Now button in PT/Internet con-
figuration window.
Error messages
*HFThe messages described in this section are among the most common that
*2Kcan appear in the log file. Lower-level messages generated by the protocol
*2Hcode are not described in this guide. Those messages usually indicate a
*2Fcommunication problem that requires resolution by the network adminis-
trator.
Courier
number
)] messages waiting up on the mail server.
MHThis is a general status message reporting the number of messages to be
downloaded.
:Cannot do a send because a server to send to has not been
*.*specified. Check your preference settings.
+:=HPT/Internet cannot send outbound mail if the Server field in the config-
uration window is empty. See
Required mail account information
page 22
for details.
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
Courier
CloseSMTPconnection error.
+:=BThis message indicates that PT/Internet encountered an error when
*2Fclosing the SMTP connection with the Internet mail server. This could
*2Bmean that the SMTP host went down during the connect session with
*2DPT/Internet. You can run ML Test to check the connection, or wait a
*2Awhile and then contact the administrator if the problem persists.
DoSMTPsend error [
number
CThis message indicates that PT/Internet encountered an error while
*2Dsending an outbound message to the Internet mail server. This could
*2Bmean that the SMTP host is down. You can run ML Test to check the
*2Fconnection, or wait a while and then contact the administrator if the
problem persists.
DoSMTPsend with file D.pmm[
number
IThis is an informational message indicating that PT/Internet is going to
*2Isend an outbound message. The file named is a processed mail file in the
Mail*Link PT/INET folder.
DoSMTPsend mfOpen error [
number
] on D.pmm[
number
GThis message indicates that PT/Internet encountered an error trying to
*2Fopen the processed mail file while attempting to send an outbound mes-
sage.
=Gateway can't run! The username field is empty. Please check
your preferences settings.
+:=IPT/Internet cannot send or receive mail if the User Account field in the
*4#configuration window is empty. See
Required mail account informa-
on page 22
for details.
<Gateway cannot run because a server to contact has not been
*.*specified. Check your preference settings.
+:=JPT/Internet cannot send or receive mail if the Server field in the config-
uration window is empty. See
Required mail account information
page 22
for details.
4Gateway is not marked as active at current location.
+:@;PT/Internet has been deactivated in the
menu. See
Activating
'or deactivating the gateway
on page 27
for details.
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Checking the log file
Courier
>Gateway will not run. Please check your preferences settings.
+:=CPT/Internet cannot send or receive mail because one or more of the
*4=required configuration parameters has not been supplied. See
Required
M$mail account information
on page 22
for details.
Ignoring [
number
1] message(s) up on the server as mail previously
downloaded.
+:=FThis message will appear when the
Delete mail from server
option is
*2Funchecked. It is an informational message indicating that PT/Internet
*2Gwill leave the specified number of
(already read) messages up on
the POP server.
@No 'To:', 'Cc:' or 'Bcc:' address to send to... can't send mail.
+:=GPT/Internet encountered an error while reading the destination address
*2Fof a message. It
s possible that no destination address was specified.
NOTE!!!! No reply address
+:=FThis message indicates that PT/Internet did not find a reply Internet
*2Iaddress for you. PT/Internet will send your mail, but recipients will be
*2Funable to reply to by using the Reply function. We strongly recommend
*4>that you set a reply address in the configuration window! See
Required
M$mail account information
on page 22
OpenSMTPconnection error.
+:=CThis message indicates that PT/Internet was unable to establish an
*2HSMTP connection with the Internet mail server. This could mean that the
*2DSMTP host is temporarily down. You can run ML Test to check the con-
*2Hnection, or wait a while and then contact the administrator if the prob-
lem persists.
PmmStart error opening TCP [
number
MFThis message indicates that PT/Internet tried to open MacTCP and came
back with an error.
POP: No greeting!
+:==The POP server didn't respond appropriately when PT/Internet
*2Hattempted to log into check for your incoming mail. The server might be
*5$down, or incorrectly specified. See
If SMTP and POP are supported on
different systems
on page 24
for related information.
POP: [
string
] error [
number
M,POP3 errors returned by the POP server. The
string
is a POP com-
M(mand, which can be one of the following:
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
*>EThe user name you specified in the mail account configuration is not
being accepted. See
Required mail account information
on page 22
If SMTP and POP are supported on different systems
on page 24
PASS
*>DThe password you specified in the mail account configuration is not
being accepted. See
Required mail account information
on page 22
If SMTP and POP are supported on different systems
on page 24
*?BThe software encountered an error when checking the POP mail box.
*2BNormally this command reports the mailbox status, such as
STAT 1
*2I123
to indicate that there is one message of size 123 bytes.Contact the
system administrator.
*?GThe software encountered an error when retrieving a mail file. Contact
the system administrator.
*?HThe software encountered an error when attempting to delete a mail file
*2Ffrom the POP server after downloading it to your In Tray. Contact the
system administrator.
*?BPT/Internet encountered a POP error when requesting the number of
*2<the last message accessed. Contact the system administrator.
Courier
Reading preferences...
+:=LThis is a status message indicating that the software is reading its prefer-
ences.
Received message.
+:=HThis is just a general confirmation that PT/Internet received a message.
Numeric error codes
*HHThe following error codes can appear in the Mail*Link PT/INET log file.
*2#Error messages begin with the word
ERROR:
, followed by a descriptive
Kstring and the error number. Any further information that accompanies this
*2Cerror message will be displayed on the following line. For example:
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Checking the log file
Courier
2:12:51 PM:
ERROR: dskFulErr(-34)
getEnclosure failed
HLog messages are time stamped, as shown in this example. The error code
in this example is
1Table 4 Macintosh file system or memory errors
Error code
Description
Directory is full.
Disk is full.
No such volume.
I/O error.
File not open.
End-of-file.
Too many files open.
File not found.
Diskette is write protected.
File is locked.
Volume is locked.
File is busy.
Duplicate filename.
H+Not enough room in the heap zone of memory.
Miscellaneous memory errors.
A resource could not be found.
Table 5 AppleTalk errors
Error code
Description
-1096:
Request failed.
-1097:
Too many requests outstanding.
-1098:
Too many sockets open.
-1099:
Bad or unopen socket number.
Table 6 TCP error codes
Error code
Description
-23000:
H/Unable to initialize the local network handler.
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
-23001:
2The manually set address is configured improperly.
-23002:
$A configuration resource is missing.
-23003:
(Not enough room in the application heap.
-23004:
DError in getting address from a server or the address is already in
use by another machine.
-23005:
:A TCPClose command was already issued so there is no more
*. data to send on this connection.
-23006:
>The total amount of data described by the WDS was either 0 or
greater than 65,535 bytes.
-23007:
.The TCP stream already has an open connection.
-23008:
'This TCP stream has no open connection.
-23009:
&There are already 64 TCP streams open.
-23010:
%The specified TCP stream is not open.
-23011:
9An open stream is already using this receive buffer area.
-23012:
The TCP connection went down.
-23013:
%The receive buffer area pointer is 0.
-23014:
8The RDS refers to receive buffers not owned by the user.
-23015:
/The connection came up halfway and then failed.
-23016:
<The specified command action was not completed in the speci-
fied time period.
-23017:
>A TCP connection already exists between this local IP address
*.>and the TCP port, and the specified remote IP address and TCP
port.
-23032:
<The packet is too large to send without fragmenting and the
t Fragment flag is set.
-23033:
=The destination host is not responding to address resolution
*- requests.
-23035:
Ping of IP address failed.
-23036:
@Insufficient internal driver buffers available to fragment this
packet on send.
-23037:
=No gateway available to handle routing of packets to off-net-
work destinations.
-23041:
@The hostName field had a syntax error. The address was given in
*.Bdot notation (that is, W.X.Y.Z) and did not conform to the syntax
for an IP address.
Table 6 TCP error codes
(Continued)
Error code
Description
Palatino
Mail*Link Internet for PowerTalk
Helvetica
"How to remove the gateway software
"How to remove the gateway software
*YGBefore you remove PT/Internet software from a Macintosh, make sure you
*4'save the contents of your In Tray. See
Mail is deleted when you remove
PT/Internet
on page 72
4 for related issues. After you copy the contents of
-your In Tray to a folder, follow these steps:
Open the Key Chain.
):DIn the Key Chain, click the PT/Internet Service item and then click
Remove.
Close the Key Chain.
*?&This causes the Macintosh to restart.
*>EWhen the Macintosh comes up, open the Key Chain again. If you see an
*2Finstalled service with no name, remove it. The Macintosh will restart
*2Dagain. When the Macintosh comes up again, the Key Chain should show
*2Hno sign of the PT/Internet service or the
empty
service with no name.
):COn the mounted CD volume, open the folder containing the Mail*Link
PT/INET Install script.
):ADrag-and-drop the Mail*Link PT/INET Install script on top of the
Installer.
):(Click Customize in the Installer window.
-23042:
H<The name specified cannot be found in the cache. The domain
*-8name resolver will now query the domain name server and
*.,return the answer in the callback procedure.
-23043:
H?No result procedure was passed to the address translation call
*.3when the resolver must be used to find the address.
-23044:
H:No name server can be found for the specified name string.
-23045:
H This domain name does not exist.
-23046:
H.None of the known name servers are responding.
-23047:
H-The domain name server has returned an error.
-23048:
H=Not enough memory is available to issue the needed DNR query
or to build the DNR cache.
Table 6 TCP error codes
(Continued)
Error code
Description
Helvetica
Solving Problems
Palatino
Mail*Link Internet for PowerTalk
):GSelect the PT/Internet software by pressing Shift and clicking on each
item.
Hold down the Option key.
*?@When you press and hold down the Option key, the Install button
*4*changes to the Remove button, as shown in
* FIGURE 44
FIGURE 44
Removing PT/Internet
):*Click Remove. Then, restart the Macintosh.
@ffF10
323&f1
f`@f$
<|8xp
<f8xp
Palatino
Mail*Link Internet for PowerTalk
Glossary
7-bit/8-bit characters
7The difference between 7- and 8-bit characters becomes
*.5important when sending Macintosh characters, many of
*.;which are 8-bit, to systems that use the eighth bit of for
*-2some other purpose. Characters that have an ASCII
*.9value <128 can (by definition) be represented in 7 bits.
*.6The original ASCII character set contained only 7-bit
*.7characters. Many of the standard Macintosh characters,
*.:such as
, require a full 8 bits for representation.
*.78-bit characters can have an ASCII value >127
both the
*-6Macintosh and ISO-8859-1 character sets contain 8-bit
characters.See
Macintosh character translations in the
message body
on page 43
AppleDouble
9A file format that separates a Macintosh file
s resource
*-8fork and data fork into two files for transmission as a
*.2data stream. Some files, such as those created in
*.6Microsoft
Word, will maintain formatting information
*.5across platforms. A non-Macintosh recipient can read
*.9the data fork only, which is present as a separate file.
About Macintosh files
on page 38
and
Encoding
on page 42
AppleSingle
8A file format that combines a Macintosh file
s resource
*.:fork and data fork in a single file for transmission as a
*-5data stream. AppleSingle header information contains
*.3the information needed to reconstruct the separate
*.1forks. Non-Macintosh users who receive a file in
*.3AppleSingle format must use the Single utility for
*0*extracting the data fork of the file. See
About Macin-
tosh files
on page 38
and
Encoding
on page 42
. See
also
Single utility
ARPANET
7A wide area network that served as a basis for network-
*.4ing research and provided a central backbone during
*.&development of the Internet. See also
DARPA Internet
Palatino
Mail*Link Internet for PowerTalk
binary file
4Any Macintosh file whose file TYPE is not TEXT; for
*.2example, a compiled program, or a Microsoft
Word
*0,file containing formatting information. See
About Mac-
intosh files
on page 38
connect session
7A series of actions performed by the gateway at config-
*.5ured intervals: (1) Extract outbound mail from Power-
*.3Talk (2) Use SMTP to send the outbound mail to the
*.5SMTP host (3) UsePOP3 to access a user
s POP account
*.3and download incoming messages (4) Submit received
messages to PowerTalk. See
Changing the connect
interval
on page 48
DARPA Internet
4Defense Advanced Research Projects Agency Internet:
*.7The collection of networks and gateways, including the
*-0ARPANET, MILNET, and NSFnet that use TCP/IP pro-
*.:tocols to communicate. Also called the Internet. See also
ARPANET
MILNET
NSFnet
DDP-IP gateway
6Datagram Delivery Protocol-Internet Protocol gateway:
*..A gateway that connects AppleTalk networks to
*..TCP/IP networks by converting a TCP/IP packet
*.4encapsulated in AppleTalk
s Datagram Delivery Proto-
*.5col (DDP) to Ethernet or Token Ring format, and vice
*-6versa. Required if the Macintosh TCP/IP connection is
on LocalTalk.
domain name resolver
3Software used by the domain name system to request
*.4information from domain name servers and decode the
returned data.
domain name server
/Software used by the domain name system to map
*0(domain names to Internet addresses. See
Choosing
&how name resolution occurs
on page 46
domain name system
6An Internet service for mapping a name to an Internet
address. See
Choosing how name resolution occurs
on page 46
e-mail
0The standard abbreviation for
electronic mail.
Ethernet
9A high-speed local area network that consists of a cable
*-4technology and a series of communication protocols.
*.7The hardware (cable) provides the physical link to con-
nect systems together.
7File Transfer Protocol: A protocol in the TCP/IP proto-
*.4col suite for transferring files across an internet.
Palatino
Mail*Link Internet for PowerTalk
5Internet Control Message Protocol: A protocol in the
*.4TCP/IP protocol suite that hosts and gateways on an
*.;internet use to inform each other of error conditions. See
Turning off the ping command
on page 47
Internet
6This term refers to the world-wide system of intercon-
*.6nected networks running the
Internet Protocol
(IP).
*. See also
Internet address
Internet address
:This can refer to a system
s IP address (a 4-byte number,
*.6of which the
network number,
between 1 and 3 bytes,
*.3was acquired from the Network Information Center).
*-5When used to refer to an e-mail Internet address, it
*.5refers to the system of Internet domains, which were
*.%developed to simplify mail addresses.
Internet mail server
9This term is used in this guide to refer to the local IP
*.7host that handles incoming and outgoing Internet mail.
If SMTP and POP are supported on different sys-
on page 24
7Internet Protocol: One of the fundamental protocols in
*.9the TCP/IP protocol suite, IP is responsible for sending
data across multiple networks.
7International Standards Organization: An international
*.8body that specifies network protocol standards. The ISO
*.1developed the Open Systems Interconnection (OSI)
model. See also
LocalTalk
3A system of cables, cable extenders, and connector
*.7boxes that link computers and peripheral devices in an
AppleTalk network system.
MacTCP
5MacTCP is software from Apple Computer, Inc. for con-
*-2necting a Macintosh computer to a TCP/IP network.
Checking your local network connection
on page
MILNET
-MILitary NETwork: A wide area network on the
*.5DARPA Internet that provides network service to mili-
tary installations. See also
DARPA Internet
6Multipurpose Internet Mail Extensions (MIME) is a new
*.9standard for Internet mail formats. It uses headers that
*.7describe the character set and content type of the mes-
*.5sage, and provides a series of extensions to the way
*.2Internet mail is formatted, including support for
*-4rich-text format, binary attachments, multipart mes-
*0%sages, images, sound, and video. See
About MIME
page 39
Palatino
Mail*Link Internet for PowerTalk
network administration
1Management of the software and hardware that con-
*.8nects computers in a network. This task includes assign-
*.9ing addresses to devices, maintaining network data files
*.4across the network, and setting up internet routing.
NSFnet
1National Science Foundation NETwork: A wide area
*.4network on the DARPA Internet that provides network
*..service to the scientific community. See also
DARPA
Internet
4Open Systems Interconnection model: A 7-layer refer-
*.0ence model developed by the ISO that is used to
*-&describe network systems architecture.
Packet
)A unit of data transmitted on a network.
PACKIT
6A format in which multiple files are compacted into a
single file. See
Multiple file enclosures
on page 41
7Post Office Protocol (POP) is a protocol for receiving
*.1and managing incoming mail. The gateway uses POP
*.3Version 3 (POP3) to access the POP server and down-
load your mail. See
If SMTP and POP are supported on
different systems
on page 24
protocol
7 A set of rules that computers must follow to exchange
data over a network.
7Request for Comments: A series of technical notes used
*-8by the Internet community that contain reports of work,
*.'proposals, and protocol specifications.
RFC 822
:The Internet standard for dealing with mail is defined in
*.6this RFC. It defines the most widespread and commonly
*.6understood message format in use on the Internet, con-
*.4sisting of standard headers and a message body. See
Macintosh character translations in the message body
on page 43
and
Internet address restrictions
on page
RFC 1341
6The MIME standard for dealing with mail is defined in
this RFC. See also
route
;The path that e-mail (or any network traffic) takes to get
from source to destination.
server
6 A program running on a host that offers a service to
*.7other hosts on the network. For instance, a POP server
*.5provides access to Internet mail accounts. Computers
*-7that run server programs are often referred to as serv-
ers. See also
domain name server
POP server
Palatino
Mail*Link Internet for PowerTalk
SINGLE
utility
5A Unix utility distributed by StarNine Technologies,
*.3Inc. as source code in the C programming language.
*.9Unix users can compile the utility and use it to extract
*.9the data fork from a file enclosure received in AppleSin-
gle or AppleDouble format.
1Simple Mail Transfer Protocol: A protocol in the
*.8TCP/IP protocol suite that allows electronic mail to be
*-6transferred across an internet. SMTP and UUCP are the
*.5most common transport agents for e-mail on the Inter-
*0 net. See
If SMTP and POP are supported on different
systems
on page 24
subnet address
6A technique that allows multiple physical networks to
*.(share the same internet network address.
subnet mask
:Software used to select bits from an internet address for
subnet addressing.
6Transmission Control Protocol: One of the fundamental
*.5protocols in the TCP/IP protocol suite, TCP provides
*.8for the reliable exchange of data between two processes.
text file
5Any Macintosh file whose file TYPE is TEXT; for exam-
*0(ple, any file saved as
Text Only.
See
About Macin-
tosh files
on page 38
UUDECODE
UUENCODE
4An encoding and decoding method originally used for
*.3UUCP mail and widely supported in gateways connect-
*.9ing to the Internet. For Macintosh or PC recipients, the
*.5receiving gateway must decode the file. Unix systems
*.;have the uudecode utility readily available for explicitly
decoding an enclosure. See
Encoding
on page 42
Palatino
Mail*Link Internet for PowerTalk
Palatino
Mail*Link Internet for PowerTalk
Helvetica
About this guide
Times
Access code, key chain
account on POP server
activating the gateway
after configuration
after turning off
!adding information to RFC headers
address record format
address resolution
name
resolution
Addresses
adding to catalog
configuring your real name
configuring your reply address
Domains
examples
Find Address
Find in Catalog
how to create an address
template
Internet address format
Internet address restrictions
Internet address template
real name field
using the addressing pane
working with Internet addresses
your Internet address
append text files to body
AppleDouble
AppleMail
default reader
example message
format required
AppleSingle
AppleSingle-uuencode
Index
Palatino
Mail*Link Internet for PowerTalk
AppleTalk
registration of gateway ID
Times
Helvetica
Application file enclosures
Bad Configuration
Balloon help
Base 64 MIME encoding
Binary files
+&3 described
methods of encoding
Binhex 4.0
blank message received
adding a message body footer
see also
Signature
translating 8-bit characters
business card, StarNine
Buttons
alert button
Connect Now
keyboard shortcuts
opening PowerTalk problem
reports
Catalog
adding an Internet address
creating a new user
creating an entry by copying a
Characters
+&3#8-bit characters in Macintosh files
garbage characters in messages
illegal in Internet addresses
ISO-8859-1 representation
translating 8-bit characters in
message body text
translation methods
Clearing log file
Close window and reboot
Codes in the log file
Command timeouts on TCP/IP
network
Compression methods
Configuration
activating
basic options
error messages
expert options
file enclosure handling
minimal requirements
opening configuration window
saving changes
verifying
see also
Preferences
Connect interval
defaults
modifying
Connect Now button
when Not Loaded
Connect session
Connection
checking IP connection
problems
required on IP network
Control Panels, MacTCP
conventions in this guide
Current State
Customize
Download All Messages
required components
Customizing RFC 822 headers
Palatino
Mail*Link Internet for PowerTalk
Helvetica
Datafork Only
Times
Datafork Only
uuencode
date, appended to log file
Datestamps
determining how calculated in
gateway
header line
header line
On first
Received
header line
When downloaded by gateway
deactivating the gateway
Defaults
AppleMail reader
connect intervals
downloading and deleting
messages from POP
enclosure handing settings
headers/footers
SMTP/TCP network parameters
Delete mail from server option
deleting old log files
Desktop, address templates
different systems for SMTP and
Disk space
PowerTalk problem report
required for gateway function
domain name server
configured in MacTCP
name resolution options
Domain name system
Domains, defined
Downloading messages
default behavior
disk space issues
Installer option
performance issues
downloading messages
without deleting from the POP
server
duplicate copies of a gateway
*0!8-bit character translations and
4 encodings
8-bit characters in body text
Enclosures
changing settings for specific
sites
default settings
!how multiple file enclosures are
handled
!issues related to Macintosh files
limiting the size of enclosures
methods for compressing files
methods for encoding binary
files
translations based on file type
using MIME encoding
see also
Formats
error messages
Ethernet
Examples
activating the configured
gateway
adding an Internet address to
your catalog
adding service to Key Chain
copying and modifying an
Internet catalog entry
creating a new user with an
Internet address
creating an address template
from a reply address
custom install
Palatino
Mail*Link Internet for PowerTalk
deactivating the gateway
temporarily
Times
Helvetica
easy install
entering an Internet address in
outbound mail
MacTCP configuration
ML Test
required configuration data
selecting a mail reader
sending a test message through
the gateway
updating
using the Internet address
template
existing messages, downloading
from POP
Expert options
Extensions,
System extensions
Extras folder
File enclosures,
Enclosures
File types, Macintosh files
"file-ID, requirements for updating
!filename extensions, mapped from
4 file type
Finder Special menu-I
Folders
Mail*Link Extras
Preferences:StarNine:Mail*Link
PT/INET
System
#Forks, structure of Macintosh files
Formats
AppleDouble
AppleMail for outgoing
messages
AppleSingle
AppleSingle-uuencode
Binhex 4.0
Datafork Only
Datafork Only
uuencode
Internet addresses
ISO-8859-1
ISO-8859-1-MIME (body)
MacBinary
uuencode
MX records
PACKIT
Plain Text
Quoted-Printable
ISO-8859-1-MIME (body)
Quoted-Printable
ISO-8859-1-MIME
(enclosure text)
Quoted-Printable-MIME (body)
Quoted-Printable-MIME
(enclosure text)
RFC 822->987 USA
Transparent 8-bit
Gateway
configuration window
DDP-IP gateway on LocalTalk
Genesis
*6!Handling outgoing file enclosures
Hostnames
domain name server in MacTCP
how IP addresses are obtained
POP server on a separate system
Palatino
Mail*Link Internet for PowerTalk
SMTP host and POP server on
same system
Times
Helvetica
SMTP host in ML Test
Hosts file
*6 ICMP ping
icons
magnifying glass
pencil
In Tray
opening a test message
installation
Installer options
updating
using Installer
Installer options
+&4 customize
Download All Messages
Internet address,
Addresses
Internet mail server, defined
TCP/IP
ISO-8859-1
see also
Quoted-Printable-ISO-8859-1
-MIME
ISO-8859-1-MIME (body)
Keep as separate files
Key Chain
adding PT/Internet
opening
opening gateway configuration
window
Key file
error conditions
see also
)| AppleTalk
"Keyboard shortcuts, in Preferences
Limit total enclosure size
Loaded
LocalTalk
log file
date appended
deleting
location
maximum size
time stamps
MacBinary
uuencode
MacMIME
MacTCP
Control Panel
Hosts file
verifying the configuration
magnifying glass icon
Mail*Link Extras
Message body
+%4 translating Macintosh characters
ML Test
error codes
error messages
launching
sending a test message
using
MX record format
Name resolution
MacTCP Only
MacTCP then StarNine
StarNine Only
StarNine then MacTCP
Network administrator required
Palatino
Mail*Link Internet for PowerTalk
Network connections
Times
Helvetica
Network Information Center (NIC)
domain name authority and
obtaining RFCs
Not Loaded
header line
header line
On first
Received
header line
PACKIT
Ping host before opening
connection
PMSAM, defined
configuring POP hostname if
different from SMTP
hostname
configuring user account
information
mail account
obtaining a server
server hostname
popper
Post Office Protocol Version 3,
PowerTalk
creating gateway service
opening Key Chain
problem reports
see also
Requirements
Preferences
Connection
Enclosures
Header Details
keyboard shortcuts
location
SMTP/TCP
Problems
bad configuration status
configuration errors
mail returned
thumbs down
reported in PowerTalk
reported in the log file
User Account information
disappears
user receives blank message
with the network connection
Quoted-Printable
ISO-8859-1-MIME (body)
Quoted-Printable
ISO-8859-1-MIME
(enclosure text)
Quoted-Printable-MIME (body)
!Quoted-Printable-MIME (enclosure
text)
*6 Real Name
Reply address
Requirements
disk space
LAN connection
Macintosh
POP mail account
PowerTalk, when updating a
service
SMTP host
System 7 Pro
Resources
location
822, header format defined
header additions
Palatino
Mail*Link Internet for PowerTalk
RFC 822->987 USA
Times
Helvetica
Send outgoing mail immediately
Signatures
Simple Mail Transfer Protocol,
checking your connection
configuring the name of the
+K3 SMTP host
error conditions
hostname
network parameters
protocol messages
sending a test message
StarNine
business card
folder contents
State
bad configuration
close window and reboot
genesis
loaded
not loaded
Support Info
System extensions
Mail*Link PT/INET
System Folder
Control Panels
Extensions
Preferences, StarNine
System requirements
Requirements
TCP/IP
checking your connection
Name Resolver
network parameters
Ping host before opening
connection
reliable connections
Simple Mail Transfer Protocol
(SMTP)
TCP Command timeouts
Token Ring
Transparent 8-bit
troubleshooting,
)1 Problems
turning off the gateway
Updating Mail*Link PT/Internet
User Account
Verifying gateway configuration
When downloaded by gateway
Palatino
Mail*Link Internet for PowerTalk
D80=A
@@P0
E0=>@AB/;D?MJ
@`
IB<>9#"(2),0
UVK+$
=/ S.
!;FEO?
21'%)-.&(/,
xP(H`X
"#$%*-.8
(0 2&
#+*(.
@`
D80=A
9:, g
E0=>@AB/;D?MJ
@88*?
IB<>9#"(2),0
UVK+$
=/ S.
!;FEO?
21'%)-.&(/,
"#$%*-.8
(0 2&
#+*(.
Ftion
temp.0001
1Management of the software and hardware that con
8nects computers in a network. This task in
StarNine Technologies, Inc.
Berkeley, California 94710.
FrameMaker
bOFST
Zapf Dingbats
Palatino
Times
Helvetica
Courier
Lmf\K
jPREC
vPRVS